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WELCOME TO 
THE OFFICIAL 
MAGAZINE 


his issue marks the fifth birthday of 
the magazine. Happy birthday us! It’s 
been an incredible journey from its 
humble beginnings as a community fanzine, 
to this issue’s Google-powered giveaway. Over 
the course of the last five years we’ve generated 
more than four thousand pages of Raspberry Pi 
content designed to help, inspire, and entertain 
you on your journey with the world’s favourite 
credit card-sized PC. 
In conjunction with our friends at Google, 
we’ve got quite the birthday present for you. 
Those of you who read the print edition will 


im ZERO 
PAG SCRIPTION 


have in your hands a brand-new kit designed 
specifically to help you bring Natural Language SEE PAGE 34 FOR DETAILS 
Interaction to your Raspberry Pi projects. 

Over the course of 20 pages, Lucy Hattersley 
expertly demonstrates the power of Google’s new 
Voice HAT, coupled with the Google Assistant THIS MONTH: 
API, to create a cardboard contraption capable of 
answering any question you put to it. That’s just 14 BUILD YOUR AIY PROJECTS KIT 
the beginning, though, and we can’t wait to hear 
about the amazing projects you make! 


Get to grips with your new Google-powered project 


Here’s to the next five years of the official 50 ADD A POWER SWITCH TO YOUR PI 
Raspberry Pi magazine. Enjoy the issue. Safely shut down your Pi without having to pull the plug 
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ASTRO PI WINNERS 


More code is about to go into space 
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WINNERS ANNOUNCED 


French astronaut Thomas Pesquet announces latest winners of Astro Pi competition 


Thomas 

Pesquet with an 
Astro Pi device on 
board the ISS. 
Credit: ESA 
(European Space 
Agency) 


n October last year, 
with the European 
Space Agency and CNES, 
The Raspberry Pi Foundation 
launched the first ever European 
Astro Pichallenge. 
Students from across Europe 
were asked to write code 
for the flight of French ESA 
astronaut Thomas Pesquet to the 
International Space Station (ISS). 
“As I have been busy doing 
science and engineering in space, 
you have been busy in your 
classrooms preparing science 
investigations,” says Thomas. He 


then thanked makers “working on 


amazing computer code with your 
Raspberry Pi [devices].” 

“This year’s competition 
expands on our previous work 


the Raspberry Pi Foundation. “The 
European Challenge provided school 
students from every ESA member 
country with the opportunity to 
design code to be run in space.” 


I encourage you to continue 
exploring using different 
ways to use Astro Pi 


with British ESA astronaut Tim 
Peake,” explains Dave Honess, the 
Astro Pi Programme Manager at 


“With so many excellent 
submissions, it was really hard 
to choose the best code to run 
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ASTRO PI EU WINNERS I7. 


NOW TRENDING 


The stories we shared that 
flew around the world 


magpi.cc/2n5UWX 


Y ~ The RX300 is a thin client computer built using a 
E Raspberry Pi. It enables people to build Windows 
à A (or Linux) virtual environments and set up offices 
- for an affordable price. 


» Above Ed, one of the Astro Pi devices > TITTY 
on the ISS,” says Thomas. The on board the ISS. Credit: ESA (European e E XAXI] - - 


LERRA RR ARARAAAAALAAA 

code runs on two space-hardened Space Agency) = PA TU 

Raspberry Pi units, or Astro Pis. 

Affectionately nicknamed Ed and In the coming weeks, Thomas 

Izzy, the units were launched into will be supervising Astro Pi 

space on an Atlas V rocket in 2015. ‘Ed’, continuously running code 
Dave reveals that the entries provided by students. 

included a cheeky bit of coding: “I Astro Pi doesn’t end here, 

found one team who were trying though - watch out for an 

to find the public IP address of announcement this September. 

the ISS. It made a call out to a web “I encourage you to continue 

server, then they tried toemail the exploring using different ways 

returned page to themselves! No to use Astro Pi to create more Our story about how one smart idea made the 

networking code is allowed to flyso amazing projects,” adds Thomas. new Pi Zero W possible intrigued the Google 

they were disqualified, but I might “Use your imagination, ask Plus community. Clever surface-mount antenna 

email them and say ‘nice try kid" ” yourself questions, and have fun.” technology from Proant enabled Pi engineers to 

add wireless networking to the Pi Zero W. 


magpi.cc/2lyUhX 


THE WINNERS 


*"*909€0€920999€990990€999€998 
io Rospderry Pi Zero W VIT FCC)IO. 2ABCB:RPTON, 


1C: 20953,RPT 
ew Ofaspderry Pi 2016 Celio i 


Everyone produced great will be uploading your code 


work, and the judges found digitally using the space-to- 
it tough to narrow the entries ground link over the next few 
down. In addition to the winning weeks. Your code will be executed, 
submissions, a number of and any files created will be 
teams were awarded 'Highly downloaded from space and 
Commended' status. These returned to winners for analysis. 
teams will also have their code A full list of winners and FREE PI ZERO W 
run on the ISS. highly commended teams can 
The Raspberry Pi Foundation be found on the Raspberry magpi.cc/2lwRp6N 
would like to say thank you to Pi Foundation website 


Get a free Pi Zero W with an official case and 


everyone who participated. ESA (magpi.cc/206mZwA). 


adapter cables! Our new subscription offer was 
the top tweet last month. 
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MonsterBorg is a rugged robot with 
a 3 mm thick aluminium chassis 


m YS 7 


KICKSTARTER TARGET 


Monster success for PiBorg’s biggest robot yet 


owering forth on its 10cm wheels, the on rough surfaces, so we thought we would design 
MonsterBorg has smashed through its something that essentially was a bigger, more 
Kickstarter target: 1749% funded, with powerful off-road version.” 


pledges totalling £52,471 (magpi.cc/20BdFzg). 

“We are stoked!” exclaims PiBorg’s Tim Freeburn, N / 

who says the robot will soon also be on general sale The onsterBorg 
from piborg.org. 


The Tim tells us the idea for MonsterBorg came about IS based on PiBorgs 


ThunderBorg following the first FormulaPi race series using the 


controller can drive YetiBore “A lot of people wanted to buy and build ThunderBorg board 


larger motors than . 
previous boards the robots themselves, but to also use it outdoors or 


Equipped with four 300 rpm Zhengke 37 mm 

> £5 motors, MonsterBorg is PiBorg's fastest, most 
powerful robot yet. *It has enough torque to flip itself 
ThunderBorc j | over when going from full forward to full reverse on 

5 Amps j flat ground!” reveals Tim. “It can tank-steer on all 
M+ Me- Vr BND M* N sorts of surfaces - grass, carpet, bitumen - and it 
m" climbs hills very well." 
- | 9 ; The MonsterBorg is based on PiBorg’s new 
. = ThunderBorg motor controller board. Also availab 
separately, this provides a dual output of up to5 A. 
A running time of up to three hours (using ten AA 
batteries) will permit longer races in the upcoming 
MonsterBorg FormulaPi series, whose use of the 
Raspberry Pi 3 should lend itself to “more complex 
code such as neural networks and self-learning 
algorithms,” says Tim. “I think we will see some 
serious entries and some really great lap times.” 


fea 


e 


j unii e 
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Western Digital, WD, the WD log 
of the Raspberry Pi Foundation. mic 
depending on operating en 


of SD-3C, LLC e 
ons subject to change without notice. Pictures 


opert; 


New resources for organisers 
of Raspberry Jam events 


aspberry Jams are hugely Communities and Outreach. “It’s 
popular community been really interesting and exciting 
events where people to gather all this advice and share it 


gather to learn digital making with in this guidebook.” 
Raspberry Pi. They’re a great way The Raspberry Jam Guidebook 
to find out more about the Pi and is a free guide to running a Jam 
meet like-minded folks. that you can download from 
The Raspberry Pi Foundation the Raspberry Jam website. The 
has released two new products to Starter Kit contains a projects 
support the teams that organise book, printed worksheets, leaflets, 
Raspberry Jams. stickers, and a copy of The MagPi. 
“The community of Jam makers It also features a branding pack 


The Pioneers programme challenges 
teenagers to form digital maker teams 
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has so much great advice for people of logos, assets, and templates 
starting their own Jam," says Clare for you to easily make your own 
Sutcliffe, Executive Director of posters and flyers to advertise 
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GUIDEBOOK 
STARTING AND R 
UNNING A 
ADVICE G RASPBERRY Jam: 


ATHERED FROM THE 


R 
ASPBERRY pj COMMUNITY 


your Jam. As soon as you have Above The new 
$ Raspberry Jam 

submitted your Jam to the calendar guidebook 

on the Raspberry Pi website, you 

can request your Jam Starter Kit. 

For more information on how to 
download the Jam Guidebook and 
Starter Pack, visit the Raspberry 


Jam website (magpi.cc/28Nxeff). 


INNERS 


he Raspberry Pi Foundation has announced 
the winners of its first Pioneers challenge. 
“We laid down the epic challenge of making 
us laugh,” says Olympia Brown, Senior Programmes 
Manager. “And boy, did the teams deliver! My face hurt 
from all the laughing on judging day.” 

Theme winners were The Technological Tricksters, 
with their Singing Potato. Heritage Hackers and their 
Water Pistol Trap won the Inspiring Journey award, 
Black Thunder and their Living Joke Robot won the 
Best Explanation award, while Shady Hackers and their 
Scare Chair Rig won the Technically Brilliant award. 

The Pioneers programme challenges teenagers aged 
12-15 to form teams of digital makers and share their 
builds online. The next Pioneers challenge will be 
announced shortly. Head over to the Pioneers website 
(magpi.cc/20MN2rc) and sign up for the newsletter to 
be kept up to date. 
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in smart technology 


ack in January 2017, we 
asked the Raspberry Pi 
community to respond 


to a Google survey canvassing 
opinions from makers. 

“We conducted a survey to 
understand how makers would 
want to use artificial intelligence 
in their work,” says Kristine 
Kohlhepp, a User Experience 
Researcher working on AIY Projects 


at Google. “These results, along 
with other feedback we gather 
from the community, will help 
us figure out where to take AIY 
Projects next.” 

The team at Google are busy 
analysing this data and plan 
to share more results via their 
website soon. In the meantime, 
you can get a sneak peek (to the 
right) of some of the results. 


The Voice HAT included with 
this month's AIY Projects kit 


SURVEY RESULTS I///7/. 


SURVEY MAKER 
RESULTS 


Results of maker survey show keen interest 


SURVEY 


IN NUMBERS 
OVER 15,000 


3% INTERESTED IN 
O 


MACHINE LEARNING 


MAKERS 


Over half of makers wanted to learn more. 
about machine learning. Of those... 


8 0% HAVE WORKED ON 


Q HAVE WORKED 
9% on 


O^ IDENTIFY AS 
T% 


May 2017 Ti 
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This chess robot moves the pieces by robotic hand 


nspired by the 18th- determines when it’s the Raspberry 
century Mechanical Turk, Turk’s turn, and it then makes a move 
Joey Meyer has built using its robotic arm, equipped with 
a chess-playing robot based on a an electromagnet to lift the pieces. 
Raspberry Pi 3 (raspberryturk.com). After the Turk spends one second 
OpenCY is used to interpret the ‘thinking’ using the Stockfish 
overhead view of the board from a chess engine, Joey tells us: “It takes 
Camera Module. A Python program between 20-40 seconds to make 
its move depending on how far it 
has to reach and whether or not it 


is capturing a piece (needs to make 
two trips).” 
Not only does the Raspberry Turk 
look impressive, but nobody has 
managed to beat it yet. “The Stockfish 
engine is so powerful that even 
running on a computer as small as the 
Pi, it can play at Grandmaster level.” 


The Raspberry Turk makes a move using its 
robotic arm, which also removes captured pieces 


oftIntegration Inc has launched Ch 8.0, 
-- -- s “the most complete cross-platform C/C++ 
interpreter”, available free for Raspberry Pi 
users as part of the C-STEMbian OS based on Raspbian 
(magpi.cc/201JVNO). The latter also includes a 
WiringPi binding for Ch to enable easier access to the 
Pi’s GPIO pins in C/C++ programs. 
Cross- platform C/C+ + interpreter , Equipped with a user-friendly IDE (ChIDE), Ch 
. İs designed to help students learn coding, robotics, 
for Raspberry Pi and maths. Wayne Cheng, SoftIntegration’s VP for 
Application and Business Development, points out: 
“Ch is a superset of C with salient features of C++ and 
DANA S ADON a 2 many extensions including computational arrays, 

NS plotting, QuickAnimation, and advanced numerical 
computing capabilities. Ch is also a command shell, a 
very high-level language (VHLL) for shell programming 
and scripting for rapid prototyping. Therefore, Ch can 
be used not only for learning C/C++, but also for serious 
software development and applications." 

As well as 1999 ISO C Standard (C99) and C++ classes, 
Ch supports many industry standards including POSIX, 


criticoldompedt 
4*(1e6*t )*exp( «6 


) 


uederdasped( t 
Her wen NT 


aint) € X11, and OpenGL. An Embedded version of Ch is also 


tô, tf; 
tn e TM i nuaber of points for plotting Running a program from 7 ; P 
Plot; ChIDE on the Raspberry Pi available, enabling users to embed Ch into C/C++ 


applications as a scripting and programming engine. 
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Roboteers from around the world E 
A : . P un e. 234 Brian Corteil's ‘2 wheels or not 2 
gathered in Cambridge for the Pi : a UT Sa wheels’ won the Pros/ Veterans event 
Wars robotics challenge | 
obot makers from around the UK and further 
afield assembled for Pi Wars 2017, the annual 


challenge-based robotics competition 
starring Raspberry Pi robots. 


This year's challenge, on 1-2 April, was held at the i E Tm x 
7 
Cambridge Computer Laboratory. Pi Wars is open to [ exat ^ga ss ! t 2017 
teams from around the world. eral i | E 2 ^ 
, a i 


The competition typically sees around 30 teams from 
schools, families, and hobbyists compete for two full 
days of robotics fun and games. 

Pi Wars 3.0 was moved from December to April, 
giving student teams an extra three months to build 
and test robots (and making it easier for students 
starting term in September to enter). Ea 

The event was held over two days, with the Saturday 
being for Schools/Kids Club; and Sunday for Beginners, 
Intermediates & Pros/Veterans. N DU S TRI 

Competitors took part in an Obstacle Course, Line 
Follower, Straight-Line Speed Test, Skittles, Slightly 
Deranged Golf and The Minimal Maze. There were also 
prizes awarded for Artistic and Technical Merit. 

ExaBot came top on Schools day, while Brian 20+ new le rojects for you r Pi robot car. 
Corteil’s ‘2 wheels or not 2 wheels’ won on Sunday. For - 
full results, see magpi.cc/20aeUqV. 


Michael Syree and the ExaBot team 
won first place in the Schools day 


ExaBot (Michael Syree) 
Kenilworth School Computer Club (Edward 
PowelL Daniel Sendula) 


Cranmere Code Club (Richard Hayler) B " kP - 
Adams' Federation (Kevin Brace) ri C | 


QM-Pi-Bot (Jon Witts) LEGO MINDSTORMS + RASPBERRY PI 


2 wheels or not 2 wheels (Brian Corteil) 
Ipswich Makerspace / Robot Tractorbot 
(Keith Ellis) 

Metabot3 (John Palombo / Lance Robson) 
KEITH 3 - ‘Mostly Harmless’ (Harry Merckel) 
Hitchin Hackspace (David Booth) 


Www.dexterindustries.com 
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PROJECTS 


< | FREE KIT NOT INCLUDED 
| WITH DIGITAL EDITION 


his month, Google is Then you will learn how to add 
launching a new initiative voice commands to your own projects. 
called AIY Projects to For example, you can register for 
bring do-it-yourself artificial commands, such as “turn the lights 
intelligence (AI) to the maker on" or “robot, turn right and move 
community. AIY Projects is a orwards". In the kit, Google has 
series of open-source designs that included an accessory board, called 
demonstrate how easy it is to add Voice HAT, that is loaded with 
AI to your projects. breakout pins to wire up a variety of 
In this issue of The MagPi, we sensors and components, as well as 
are thrilled to present the very the microphone and speaker. 
first project, a free kit that lets Google can't wait for makers to 
you explore voice recognition and build intelligent devices that solve real 
natural language understanding. world problems and share them back 
You will build a cardboard device to the community to inspire others. 
that uses the Google Assistant to Your kit is a fantastic way to add 
answer questions, like “how far voice control to your projects, and 
away is the moon?" or *what is 18 start exploring what's possible 


percent of 92°”. with Al. 


AIY PROJECTS 
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JA MADE BY 
A YOU WITH 


atural H 


uman Interaction 


is this idea of being able 


to comit 


unicate with an 


electronic device the same way 


you and I are tal 
says Billy Rutled 


zing right now,” 
ge, Director of 


ATY Projects at Google. We’ve 


caught up at Raspberry Pi 


Towers 


to discuss the A 


Y Projects kit, and 


the future of artificial intelligence 


with the maker community. 


*We're all familiar with 


graphical user interfaces (GUI)", 


notes Billy. “We 


ll, building a VUI 


is now the big thing.” Voice has 


16. |- MägPi May 2017... 


become “very popular” in the last 


year, says Billy. “Not just with 


consumer products, but also as a 


I 
set of tools fo 


Google wan 


interfaces, bu 


“We're exci 


to tap into the creati 


r device makers.” 
ts to help makers 


familiarise themselves with voice 


the maker community. 


into the world and see what people 
make with them,” says Kristine 


<ohlhepp, a User Experience 
Researcher working on AIY Projects 


at Google. “We’ve done a lot of 


t it’s also really keen 
ve prowess of 


ted to put the kits out 


€ 


research to make 


sure people can 


assemble the kit and figure out 


how to make it work." 


“The initial project is just an 


opener," reveals Blaise Agüera 


y Arcas, Principal 


Scientist at 


Google. “It’s fun to be able to 


make a cardboard 


Google Assistant, 
alot more than ju 
lower-cost DIY ve 

The future belo 


devices. Billy says 


kit that uses the 
but this is about 


st making a 
rsion of Home." 


3gs to intelligent 


: “At some point 


soon, we’ll see ar 


ew generat ion 


of devices that you can just walk 


raspberrypiorg/magpi 2 : 


t 


AIY PROJECTS 


Teature 


devices 


devices, alongside touching 
tons and screens. “We can 
ly become distracted by 


but 
easi 
pe 
systems," says Blaise. 
It's important for makers to 
rea 


it 


K 


m 
M 


in 
a 


they can create, an 
projects. 
makers see how ea 
Al, specifically Na 
nteraction capabi 
projects will be a great thing," 
says Kristine. 


and keep the w 


Engin 
Google. *Getting k 
to the world with Raspberry Pi 


tand way." 


Natural Human Inte 
is the term used for this kind of 
interac 


OW We are movin 


interface where yo 
conversation with 
It's also important to ease 
people into A 
natural interaction with electronic 


asp 


ons and displays. 


up to and ask ‘what are you and 
what do you do? Then you'll 
have a conversation with it, to 
use its services in a very easy-to- 
unders 


action 


tion between humans and 
. “A genera 
all of our devices had analogue 
dials and knobs," explains 
Billy. “Then there 
to digital butt 


tion or two ago, 


was a shift 


g toa human 
u simply havea 
the device. 


art of their 


“What’s interesting about 
happens when we shut up, and 


se. Historically, there 
have been many ‘Hello World’ 


programming languages and 
platforms, and in recent yea 


Al, anothe 
and developers to add to their 


very keen to see.” 


We want to show you 
how easy it is to use Al 


rsonification of 


ise that VUIs a 


) 


“T think | 


these kinds of 


e something 

d use, in their 
etting the 
sy it is to put 


tural Human 


ities, into their 


“We want to show you how easy 
is to use Al, and then share back 


“My top-sec 
ore engineers, 


» 


lows us to build t 


th 


with us to inspire new project ideas 
hole cycle going, 
istine continues. 
et plan is to build 
discloses 
cLurkin, Senior Hardware 
eer of AIY Projects at 


» 


ts like this out 


he things that 


en create more engineers." AIY 


Projects enables young makers to 
explore the possibilities with AI. 
*So this is very exciting for us," 
says James. 


“T view this as an essential 


component in a maker's toolkit," 
Billy tells us. “We want makers 


to see that using Al is not 
or complex.” 


The Australian artist Stelarc has 


said that technology const 


not be who we are i 


and built Raspberry Pis,” says 
Blaise. “That is what being 
human is all about, 


The Voice HAT allows 
makers to create Voice 
User Interfaces that can 
control their projects 


the maker environment is what 


isten, and see what people try,” 


types of starter projects for various 


s we've 
seen exciting new hardware like the 
Raspberry Pi emerge. Now there is 
technology for makers 


projects. AIY Projects brings these 
three things together, which will be 
super interesting," reckons Blaise. 
“I don’t know what will come out 
rom the mixture of those, but m 


hard 


ucts 
our human nature. “We would 
we hadn't 
invented fire and woven clothes 


The AIY Projects team meet up with The MagPi and 


Eben 


and 


G 
tot 


thei 


Irom 


a compet 


Upton at Pi Towers 


itive lands 


exceptionalism, and ways that it 


) 


is being eroded. That really misses 
point of what all this is about. 
is first kit showcasing voice 


st the start of o 


bring Google AI to t 


evea 


owing voice, we 
ojects wit 


oogle wants ma 


r results with o 


wan 


nee 


with them 


t to learn what 


ds,” says Billy, ‘ 


that’s what distinguishes us 
the other animals. So I don’t 
this idea that talks about Al as 


l largely 
ural Human Interaction. 
earning. 


heir own projects, and share 
thers. “We 


cape of human 


fort to 
he make 
Is Billy. “Our 
ocus on 


ure 
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ntend to 
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» 
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this community 
*and then work 
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too 


s they want.” 
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Construct your free 
ATIY Projects voice kit 
and explore natural 
language recognition 


nside the kit will be the 

components you need to build 

a voice-capable device with 
Raspberry Pi. 

Open the box and you'll find two 
pieces of cardboard, an arcade- 
style button, a speaker, and some 
cables, along with a HAT (Hardware 
Attached on Top) board and another 
narrower board. One is to connect all 
the accessories together; the other is 
a stereo microphone. 

All of these components fit 
together to build the AIY Projects 
kit: a small cardboard device with a 
colourful button on the lid. You press 
the button, or clap your hands (or 
create a custom trigger), and speak 
out loud to ask the device a question. 
The speaker, at the front, then 
announces the answer. 

Tucked inside the cardboard device 
are all the components. Use the Bill 
Of Materials list below to check you 
have all the components. 


LE 


Vc d AS * | À / BL | : | ] | | ith all your parts ready, The Raspberry Pi is the brains of 
=f sep 4 i | - ‘ it’s time to build the AIY the outfit: it connects to Google’s 


| Projects voice kit. Theaim cloud services through a local 
is to assemble all the included Python application. The Python 
parts (and a Raspberry Pi board) source code is provided with 
and create a small cardboard the software image, as well as 
device with a button on top. on GitHub. 
X This project is a relatively easy Also take a close look at the 
) build, and you won't need to smaller microphone board, 
solder any of the components. which enables the device to hear 
$ Be careful to line up the wires you speak. 
: » correctly, especially the wires But first, we need to get it all 
^ for the button. It's also a good assembled. The first step is to 
idea to take a close look at the nount the Voice HAT accessory 
Voice HAT accessory board (the board to your Raspberry Pi, and 
larger board). The Voice HAT is hen connect the speaker anc 
the heart of the AIY Project kit, microphone. Then you!ll move on 
and everything connects to it. It o folding the cardboard case and 
also provides breakout GPIO pins, placing the components inside. 
y organised into two blocks: Servos Finally, you!ll assemble the 
and Drivers. arcade-style button and secure it 
You'll connect the Voice (and the microphone) to the case. 
HAT accessory board to your Ready? Let's start building 
Raspberry Pi via the GPIO pins. your kit. 


raspberrypiorg/ magpi : 


20. MéigPi May 2017 PEE 


AIY PROJECTS Peeling 


e Raspberry Pi 3 - Small, needle-nose pliers - Phillips oo screwdriver - Scotch tape 


SET UP THE 
VOICE HAT 


© INSERT THE 
STANDOFFS 


Start with the two standoffs. These are the small 


© ATTACH THE 
SPEAKER WIRES 


Take a close look at the Voice HAT 
accessory board and find the blue 
terminal with two small screws. This 
terminal is the speaker connection (it 
has ‘Speakers’ printed above it on the 
board). Each of the two connections 
plastic cylinders, and they fit into the yellow has a small ‘*' and '-' symbol printed 
below. Find the speaker with the red 
and black wires attached. Insert the 
red wire into the positive '*' terminal on 
the Voice HAT accessory board. Now 
add the black wire into the negative 


mount holes on the Raspberry Pi board. Insert 
the standoffs into the two yellow holes on the 
opposite side from the 40-pin GPIO header (on 
the same side as the HDMI connection). Push 
them firmly, and they will hold in place. 

‘- terminal. They won't be fixed yet, so 
hold them in place. 


SECURE THE HAT 


Now get the Voice HAT accessory board and 
attach it to the GPIO pins on the Raspberry Pi 
board. Carefully line up the GPIO connector 

on the Voice HAT accessory board with the 
pins of the GPIO header on the Raspberry Pi. 
Gently press down to make sure the Voice HAT 
accessory board is secure. Press down on the 
spacers on the other side of the board to snap 
the boards together. 


Q SCREW IN 


THE WIRES 


At this point, the two wires will be sitting 
in the sockets unsecured. Hold the wires 
in place, and gently turn each screw in 


the socket using a Phillips 00 screwdriver. 


Gently tug on the wires to make sure 
they're secure. Now place the speaker to 
one side of the board so you can access 
the other components. 


Find the Voice HAT microphone board 
and the 5-wire daughter board cable. 
The cable has matching white plugs 
on either end. Both ends of the cable 
are identical, so take either end of the 
5-wire connector cable and slot it into 
the Voice HAT microphone board. It 
will only fit one way around. Snap the 
cable in, but don't force it. 


Q THE MICROPHONE CABLE 


THE BUTTON CABLE 


Find the 4-wire button cable: it has a 
white male connector on one end and 
four separate wires with metal contacts 
on the other. Insert the white plug into the 
matching white socket marked ‘Button’ on 
the Voice HAT accessory board (it is the 
one nearest to the red button). The cable 
will only go in one way around, so don't 
force it. Check that the colours of the cable 
match the image. Don't worry about the 
four separate wires with metal contacts; 
we'll come back to these later. 
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Do the same for the other folds, tucking FOLD 4 
underneath to secure it in place. Now set it aside. 
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Find the other cardboard piece that came with your kit 
(as shown in the picture). This piece will build the inner 
frame to hold the hardware. Fold the flaps labelled 1 

| and 2 along the creases. 


The flap above the 1 and 2 
folds has a U-shaped cutout. 
Push it out. 


Find your speaker (which is now 
attached to your Raspberry Pi 3). Slide 
the speaker into the U-shaped pocket 
on the cardboard frame. 


Turn the cardboard frame around. Take the 
Pi * Voice HAT hardware and push it into 
the bottom of the frame below flaps 1 and 
2 (pictured). The cardboard frame should 
expose the USB ports of the Raspberry Pi. 
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(9 PUT IT ALL TOGETHER €% CHECK THE WIRES 


It's time to put the build together. First, remove the SD card Once it's in, the Raspberry Pi 
from your Raspberry Pi to prevent damaging it. Now take the should be sitting on the bottom 
cardboard box you assembled earlier and find the side with of the box. Make sure your wires 
the seven speaker holes. Slide the cardboard frame and are still connected. 
hardware into the cardboard box. Ensure that the speaker is 
aligned with the box side that has the speaker holes. 


^ 

| > |se »- i M | 
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€ CHECK THE PORTS 


Check the holes in the cardboard 
box. The Raspberry Pi ports 
should be clearly visible. 


c: ^ 


One hole provides access 
to the USB ports. These 


1 ports enable you to hook 
The AIY Projects voice kit is designed f | up a keyboard and mouse 


to work without a display, but you " | j to the AIY Projects kit, 


can access the HDMI socket for EH although it is designed to 


troubleshooting. This hole also 1 be controlled hands-free 
provides access to the power socket. with your voice. 
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(D PACK THE ADD THE BUTTON 
ARCADE BUTTON 


Insert the plastic button into 


Find your arcade button. There will be a the top flap of the cardboard 
plastic button, a spacer, and a nut. If they're box from the outside in. The 
connected, unscrew the nut and spacer from pushable button side should 


the main button and place them to one side. face outward, with the larger 
screw on the inside; i.e. the side 
marked 'BUTTON Spacer first: 


€) SECURE 
THE BUTTON 


Now take the spacer 
) and add it to the screw. 
Next, screw in the washer 


to secure the button in 
place. Make sure that 
the spacer sits between 
the washer and the 
cardboard lid. 


€& THE BUTTON LAMP © @ INSERT THE LAMP 
Next, we're going to assemble the button É Insert the Lamp into the Black Lamp 
lamp. This lamp lights up the button and — j Holder. Look at the image to see which 
displays the status of the device. There fi Way around it fits. The light should face 
are three principal components to use: $4 outwards. You may need to adjust the 


Lamp, Black Microswitch, and Black | rotation later to get a good connection. 
Lamp Holder. Make sure you have all 


three to hand. 


@) ATTACH THE LAMP 
Now attach the Black Lamp Holder 
(with the Lamp) to the Black 
Microswitch component. Two 
protrusions on the Black Lamp 
Holder match the indentations on 
the Black Microswitch. Observe the 
position of the red button on the 
Black Microswitch component. Clip 
the two parts together. 
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You now have a completed lamp with a microswitch 
mechanism. Look at the button to see spacers that press 
down on the red microswitch. When you press the button, it 
pushes the microswitch. Insert the lamp into the button. 


Locate the four coloured wires 
with metal contacts that you 
previously connected to the 
Voice HAT accessory board. 
Using the annotated 
picture, attach the four 
metal contacts to the 
corresponding metal 
contacts on the Black 


Microswitch. Connect 


the wires to the contacts 
using this guide. 


P ECN 
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PR ET 


MUNERA RS LL NUUS! 


That's it. Your voice kit is assembled, and you can now start ; 
installing the software and using the Google Assistant to -— 
answer your questions. Fold the top flap down 

to close the box up and admire your handiwork. 
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_ SOFTWARE 


RATT RIOD madahab Sintia i POTTED 


"TDAP Te EION BIO PEN COENEN OD at 


e. ungere Assistant SDK | 
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aiyprojects.withgoogle.com/voice/ 


Use the Google / 


a device n answer 


J 
a l d 


A 


Assistant SDK to create 


your qu uestions 


Ips 


- A a | 
S yol ngs done 


gett thir 


ou now have a fully 
Vou ll Need assembled cardboard 
device that is almost ready 


* Assembled AIY 
Projects kit 


* MicroSD card 


* AIY Projects 
image file 


* Google account 


to respond to your questions. 

To do this, you'll set up a Google 
Developer project and activate the 
brand-new Google Assistant SDK. 

Google has provided a 


Python sample application that 
demonstrates how to use the 
Google Assistant SDK. To set it 
up you'll need to download the 
AIY Projects image file from 
aiyprojects.withgoogle.com/voice/. 

Burn the image file to a microSD 
card using a program like Etcher 
(etcher.io). This software copies 
the image file to the SD card (see 

) 


‘Burn SD cards with Etcher’, 
magpi.cc/2fZkyJD). 


>STEP-01 

Set up the SD card 

nsert the SD card and connect 

he software image 

is based on Raspbian, so it feels 
amiliar. Alternatively, you can 
eplace it with a software image 
based on Android Things. For more 
information on using Android 


the power. T 


Things, visit the AIY website 
(aiyprojects.withgoogle.com/ 
voice). 


>STEP 2 

Set up the network 

Click on the Networking icon and 
choose your network. Now double- 
click the ‘Check WiFi! icon. 


>STEP 3 

Check the audio 

Next, double-click the ‘Check 
audio’ icon. If there is a problem, 
check the Voice HAT accessory 
board’s connection to the speaker 
and microphone. 


>STEP 4 

Set up the cloud 

Open the Chrome web browser and 
click on Google API Console in the 
Bookmarks bar (or enter 


console.cloud.google.com in 
the URL field). Enter your Google 
Account ID and click Next (or 
create a new account). Enter your 
password and click ‘Sign in’. 


>STEP 5 

Create a project 

Click the menu icon marked 
‘Project’ and choose ‘Create 
project’. Give the project a name, 
like ‘aiyproject’, and click Create. 


>STEP 6 

Enable the services 

Click on the ‘Products & services’ 
menu and choose API Manager. 
Search for and click Enable API at 
the top of the screen. Click Google 
Assistant API and click Enable. 
While you're here, select Speech 
API and click Enable. 


>STEP 7 

Set up OAuth consent 

Click on Credentials in the API 
Manager sidebar (on the left) 
and choose the ‘OAuth consent’ 


screen tab. Enter the name of the 
app, such as ‘ATY Project’ 
‘Product name shown to users’ 
field. Click Save. 


, in the 


.. taspberrypiarg/mac 
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>STEP 8 

Create OAuth client ID 

Click Create Credentials and 
select ‘OAuth client ID’. Choose 
Other and click Create (it will 
be named ‘Other client 1’ 

by default). A window will 
appear with your client ID and 
client secret. 


>STEP 9 


Download credentials 

Look to the right of the ‘Other 
client 1’ item and locate the 
download icon. Click the download 
icon to save the JSON file. 


>STEP 10 
Rename credentials 


Open a Terminal window 
and enter: 


cd Downloads 
1s 


You will see a file called 
client secret with along 
ID number after it. We need 
to rename the file to 
client secrets.json and move it to 
the home folder. Enter this: 


mv client secret 


Press TAB to autofill 
the file name and add 
/home/pi/client_secrets.json 
as the destination. The command 
looks like this: 


mv client_secret_[123etc] 
/home/pi/client_secrets.json 


>STEP 11 

Create service account 
Head back to Google Cloud 
Console in the browser and click 
Create Credentials again. 
time choose ‘Service account 
key’. Click the ‘Service account’ 
menu and choose ‘New service 


This 


account’. Give it aname, such as 
‘ATY Projects’, and change the 
Role to Project > Owner. Make 


sure the Key type is JSON and click 
Create. The Key is downloaded to 
your computer. 


>STEP 12 

Create credentials 

Find the file you’ve downloaded. 
You need to rename the file 
credentials.json and place it in 
your home folder. 


mv aiyproject-[123etc] 
/home/pi/credentials. json 


>STEP 13 

Activity controls 

In your web browser, visit 
myaccount.google.com/ 
activitycontrols. Sign in using 
the same account and turn each 
of these items on: 


* Web & App Activity 

* Location History 

* Device Information 

* Voice & Audio Activity 


These are required for the Google 
Assistant to run. Now close the 
browser window. 


>STEP 14 

Start the voice unit 
Double-click the ‘Start dev 
terminal’ icon and enter: 


src/main.py 


A Request for Permission window 
appears. Click Allow. Copy the code 
from the web browser and paste it to 
the command line in the Terminal 
window. Press RETURN and you will 
see ‘Press the button on GPIO 23 
then speak, or press Ctrl+C to quit... 


>STEP 15 

Push the button 

Push the button on the top of your 
device and it will display: 


) 


[INFO]main:listening... 
[INFO]main:recognizing... 


Ask the device a question, 
such as *what is the weather 
in Cambridge?” 

The AIY Projects voice kit speaks 
out the answer. Keep pushing the 
button and asking questions. Press 
CTRL*C when you're done. 


>STEP 16 

Clap your hands 

You can set up the voice-recognizer 
to respond to hand claps. Enter this 
command in the Terminal: 


nano /home/pi/.config/voice- 
recognizer.ini 


before this 


Now remove the 
line of code: 


trigger - clap 
Press CTRL+O and press 
RETURN, then CTRL*X. 


>STEP 17 

Listen on boot 

Now set up your device to start 
listening automatically. Double- 
click ‘Start dev terminal’ and enter 
the following command: 


sudo systemctl enable voice- [75 
recognizer 


The Terminal displays 'Created ; 
simlink from’ messages. Finally, V 
reboot your Raspberry Pi. 


androidthings 


Android Things is a new OS for connected devices 
that is fully compatible with the AIY Projects kit that 
you received. Developed by Google, it is a ready-to- 
use solution for building connected devices. 

Developers can use existing Android development 
tools, security updates, APIs, resources, and a thriving 
developer community. It also includes new Android 
framework APIs that provide low-level 1/0 and 
libraries for common components like temperature 
sensors and display controllers. 

In addition, a wide range of Google APIs and 
services, such as Google Play services, TensorFlow, 
and Google Cloud Platform are available on Android 
Things. Developers can push Google-provided OS 
updates and their own app updates, using the same 
OTA infrastructure used on Google's own products. 

To get started on building your kit with 
Android Things, visit the AIY Projects website 
(aiyprojects.withgoogle.com/voice). More 
information about Android Things is available on the 
developer website (developer.android.com/things). 
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f^) Google Cloud Platform 


Swap out traditional interfaces with a custom 
Y Projects voice kit 


voice control using your ATY 


y now, you have built a trigger and which API to use for 
device that embeds the voice recognition. Don't worry: If 
Google Assistant. That's The source code for the voice- you mess it up, there's a backup 
cool, but it's just the beginning. recognizer app is part of the copy kept in home/pi/voice- 
With Google Cloud Speech API, image that you've just installed. recognizer-raspi/config. 
you can create an interactive, You can view the Python source 
= - custom Voice User Interface (VUI) code in the /home/pi/voice- 
je, $c 2 : Or your project. recognizer/raspi/ directory. 
TUE b a yrs This enables you to explore a You should already have the 
| t At a RRS OT new generation of devices that credentials.json file in your 
WO a you can have a conversation home directory. We installed 
with, without the need for The application can be configured this in the previous tutorial. This 
emote-control devices (such as by adjusting the properties found provides access to the Google 
joysticks or smartphone apps). in /home/pi/.config/voice- Cloud Speech API. Double-click 
Let's reconfigure the kit to use recognizer.ini. This file lets you the Check Cloud icon on the 
the Google Cloud Speech API. configure the default activation desktop to test the Google Cloud 
se Speech API. If it says ‘Everything’s 
set up to use the Google Cloud’, 
close the Terminal window and 
S 


kip ahead to Step 5 


' raspbérrypiorg/magpl 


If you do not have credentials.json 
in your home directory, open the 
API Manager in Cloud Console and 
choose Create Credentials > Service 
account key. Select your project 
under Service Account or choose 
ew Service Account (give it a 
name and set the Role to Project 

> Owner). Choose JSON as the Key 
Type and click Create. Rename the 
file to credentials.json and place it 
in your home directory. 


You need to have the Cloud 
Speech API enabled to use the 
service. Open the API Manager 
in Cloud Console and choose 
Library. Click on Speech API and 
click Enable (if you see Disable, 
it’s already enabled and you can 
ove on). 


3 


need to have billing set up 
with Google to use the Cloud 
Speech API. Open Cloud Console. 

f you don't have a billing account, 
click *New billing account? and 
go through the setup. Check your 
project is selected in the Projects 
menu at the top. Click Products & 
Services » Billing. To connect or 

change the billing account, click 

the three-dot button, then select 


‘Change billing account’. 
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It's time to turn on the Cloud 
Speech API. Editing the config 

file enables you to switch from 

the Google Assistant SDK to the 
Cloud Speech API. Open a Terminal 
window and enter: 


Delete the 


before this line: 


Press CTRL*O, press RETURN, then 
CTRL+X to save and exit. Now enter: 


Open ‘Start dev terminal’ and enter: 


You can now issue a limited 
number of commands: 


What are the three laws of robotics? 
Hello 

What time is it? 

Volume up 

Volume down 


Press CTRL+C to quit the interaction. 
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You can create new actions in 
src/action.py, and enable them 
in src/main.py. To control an LED 
that you’ve connected to GPIO 4 
(the leftmost pin marked o under Wak iris 
Drivers on the Voice HAT Action), j 
add action.py code to src/action.py: 


Then add the following main.py 
code to src/main.py under other 
calls to actor .add_keyword: 


You can discover more information 
on using the GPIO pins at 
aiyprojects.withgoogle.com/voice. 


What makers around 


y now you will have set up 

your AIY Projects voice kit, 

and discovered how to add 
Natural Human Interaction to your 
projects. Wow! 
he question is: what are you 
going to build? What projects will 
be amazing with voice control? 
The good news is you're not 
alone. Thousands of members of 
the Raspberry Pi community will be 
building Natural Human Interaction 
projects. And we want you to share 
them with us, and each other. 

To get the ball rolling, Google 
has been running a Hackster 
community for Google Beta 
Testers. These lucky makers were 
sworn to secrecy and received an 
ATIY Projects voice kit early. 

We asked members of the 
Hackster group and members 
of the Raspberry Pi community 
working in voice control what they 
thought the best ideas for projects 
were. Here are their suggestions 
for projects they'd like to build. 
Now it's your turn. Create 
something amazing and share it 
with the Raspberry Pi community 
on Hackster (magpi.cc/20Pxónb). 
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the world are buildi 
with the AIY Projects voice kit 


MAGIC MIRROR 


Add a Voice User Interface to a mirror 


display for the ultimate creative assistant 


magpi.cc/2nwpxBA 


Michael Teeuw's Magic Mirror came first in our Top 


50 list of greatest projects. 
Perhaps the only thing that could make this 
project more awesome would be voice control. 
The good news is that Magic Mirror has a 


powerful community behind it. And they've already 


been busy working with voice interaction. 
MMM-Hello-Mirror, by a user known as 
Matzefication, is a voice control system for the 
Magic Mirror based on Google Speech Recognizer 
(magpi.cc/2nwyGtO). The AIY Projects kit will 
make a Voice User Interface a real possibility. 
Your reflection has never looked smarter. 


Adding voice control to the Magic Mirror 
makes it more naturally interactive 


Sete 


* 


GH 


“I have one of these Nabaztag 
IoT devices,” says Bastiaan Slee. 
“They were ahead of time and 
didn’t survive. Now it’s time to 
give it a new breath.” 

Bastiaan plans to use servos 
to move the ears, LED lights for 
notifications, and perhaps add a 
camera and ultrasonic sensor to 
sense the nearby presence of a 
person. “If there is still space in 
his body, who knows what more 
will be added?”, he tells us. 
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Subscribe in print for 12 
months today and receive: 


A free Pi Zero W (the latest model) 
Free Pi Zero W case with three covers 


Free Camera Module connector 
Free USB and HDMI converter cables 


s 
e 
le 
ds 
le 
e 
. 
e 
fe 
e 
LJ 
e 
. 
. 
[2 
. 
. 
. 
LJ 
. 

9^ 


Other benefits: 


Save up to 25% on the price 
Free delivery to your door 


Exclusive Pi offers and discounts 
Get every issue first (before stores) 


: azine 

ry Pi maga 
ja) RaspheT 
The offici 


| INCREDIBLE 7. 


| mun PROJECTS ` 
| x z IRSE $2 Camera : 
de E ey 


34 | MägPi May 2017 raspberrypi.org/magpi 


» SUBSCRIPTION FORM 
Pricing I|] ie e S 


This subscription is: m For me ü A gift for someone* 


Mag#57 


Ms 


Get six issues: 
£30 eren 
£45 Daytime phone 


S 6 9 *[f giving The MagPi as a gift, please complete both your own details (above) and the recipient’s (below). 


Mrl | mrs| | Miss | msl | 


£ 5 O First name 


Address 


PAYMENT OPTIONS 


£12.99 every 3 issues (UK only) 
Instruction to your bank or building society to pay by Direct Debit 


Please fill in the form and send to: 
The MagPi, Select Publisher Services Ltd, Service user number 
1 PO Box 6337, Bournemouth BH1 9EH 


Name and full postal address of your bank or building society: 
To: The Manager Bank/building society 
Address 


Name(s) of account holder(s) .... 


Branch sort code L m | L] L] m] Accoun! 


Reference (Official use only) 


Instruction to your bank or building society 


e e Please pay Select Publisher Services Ltd Direct Debits from the account detailed in this instruction 

e re e 1S sue S subject to the safeguards assured by the Direct Debit Guarantee. I understand that this instruction 
e may remain with Select Publisher Services Ltd and, if so, details will be passed electronically to my 

bank/building society. 


£12.99 (Uk) (Direct Debit) $... BEER 
$37. 50 ( quar terly) anks and building societies may not accept Direct Debit instructions for some types of account. 


SUBSCRIPTION PRICING WHEN PAYING BY CHEQUE OR CREDIT/DEBIT CARD 


GISSUES UK £30 Europe £45 | !Restof World £50 


12 ISSUES UK £55 Europe £80 | _|Rest of World £90 


How to subscribe: 


Ienclose a cheque (made payable to Select Publisher Services Ltd) 


MasterCard Maestro Switch 


Card number L] | IL | | 


Expiry date Valid from (if shown) 


Issue number (if shown) Security number 
(last3 digits on the back of the card) 


Signature / / 


I would like my subscription to begin from issue (month + year) 


4 Available on the 


RETURN THIS FORM TO: 


€ A p p Sto re MagPi Magazine Subscriptions, Select Publisher Services Ltd, PO Box 6337, 


Bournemouth BH1 9EH 


Please tick this box if you DO NOT want to receive any other information 
from Select Publisher Services Ltd. 


GET IT ON Pleasetickthis boxifyou DO NOT want to receive any other information 


G | P| from other companies. 
00g e ay Please tickthisboxifyou DO NOTwant to subscribe to The MagPi newsletter. 


raspberrypi.org/magpi May 2017 MagPi | 35 


Since his last thermal printing camera 
build, the release of the Pi Zero 
allowed Pierre to shrink the build size 


» Pierre installed 
an on/off 
switch for 
shutdown 


» He printed 
the case via 
anonline 
3D-print service 


» Everything is 
available from 
his GitHub repo 
magpi.cc/ 
2ndslE3 


» You can 
navigate past 
images via 
button press 


» Watch the 
camera in 
action here 
youtu.be/ 
8D-sL3GoFZM 
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The small size of the Adafruit 
Nano Thermal Printer makes 
it the perfect partner for the 
Raspberry Pi Zero 


Pierre kept the LCD display in 
black and white to give a better 
impression of the final print result 


PI-ZERO 


The tiny Zero- powered thermal-printing camera that recreates 
the joy of using a Polaroid 


he PolaPi-Zero is the 

second iteration of Pierre 

Muth's exploration into 
portable photography with the 
Raspberry Pi and thermal printer. 
No stranger to thermal printing 
builds, he's previously created 
such wonders as a camera booth 
lottery ticket system. Take your 
photo and if your thermal printout 
displays another's face, locating 
them grants you both a free beer. 

So while his original PolaPi 
model also housed a Raspberry 
Pi - the version 2, with a full-size 
casing - the newer model allows 
for a smaller body with its use of 
the Raspberry Pi Zero. 
We've seen many digital camera 

builds using the Raspberry Pi and 
Camera Module. From 3D- printed 


cases to retrofit vintage classics, 
the majority act as simple point- 
and-shoot cameras. The PolaPi- 
Zero, however, takes its lead 

from the iconic Polaroid camera, 
utilising a thermal printer inside 
its body to deliver instant prints of 
your subject matter. 

In his original PolaPi build, 
Pierre had been forced to 
cannibalise a retail-grade thermal 
receipt printer, leaving the unit 
bulky and weighty. With the new 
model, following in the footsteps 
of the small-bodied Raspberry Pi 
Zero, he managed to acquire the 
Nano Thermal Receipt Printer 
from Adafruit: a smaller device 
marketed specifically for use with 
boards such as the Raspberry Pi 
and Arduino. Coupled with a Sharp 
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Tite: PolaPi~Zero 


>STEP-01 
The inside 
The schematics for the build are similar 


to Pierre's original camera. The only 
differences are the added LCD screen 


>STEP-02 

The outside 

Pierre designed the case and used an 
online 3D-print service to complete 
the process. The white colouring of the 


>STEP-03 

The PolaPi-Zero 

Pierre used the opportunity to utilise 
new, smaller components as a means to 
simplify the overall technical build and 


and buttons for reviewing previously 
captured images. 


memory LCD, the camera allows 
its user to see the image on screen 
in black and white before printing, 
guaranteeing the quality of the 
photograph before you commit to 
the print. 

Pierre used the project as 
“a good excuse to start learning 
Python (finally)”, in part due to 
the array of existing Python code 
available online. His original 
camera ran using Java, and though 
he admits to the final Python code 
not being “the most elegant”, he 
provides it via both his GitHub repo 
(magpi.cc/2ndslE3) as complete 
code, and as a downloadable image 
for the Raspberry Pi Zero. 

For the physical body of the 
camera, Pierre designed the unit in 
Autodesk 123D before sending it to 
an external 3D printing company, 
3DHubs.com, for completion. 


camera is, in part, a homage to the White 


Box artwork by Vit HaSek. 


Again, he provides the case 3D 
print files in his GitHub repo. 
Completing the build with a Pi 
Camera Module, a 7.2V battery 
with voltage regulator, and a 
handful of buttons, the PolaPi- 
Zero is good to go, providing 
instant gratification to any user 
wishing to immortalise their 
photography on receipt paper. 


So what next? 

With the technology in place, 
Pierre started to experiment with 
different styles of image capture. 
Starting with the idea of slit-scan 
photography, where a movable 
slide with a slit cut in it is passed 
between the lens and subject 
matter, Pierre played around with a 
coded variant. The result is an odd, 
stuttered image effect that varies 
depending on whether the scan 


add extra features, such as the ability to 
view previous images. 


reads horizontally or vertically. 
The continuous length of the 
thermal camera paper allows this 
effect to be captured and printed. 

Pierre claims to live *always 
with the hope to make something 
and not just use something", and 
as his interesting builds continue 
to wow us, we look forward to 
seeing what comes next. 


Examples of 

the slit-scan 
photography that 
Pierre has been 
experimenting 
with using the 
PolaPi-Zero 
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MICHAEL DARBY 


Atech nerd from a young age, 

obsessed with computers and tech, 
| with a dream to one day be like 

Tony Stark. 

314reactor.com 


WINDOWS 98 


Windows 98 

is emulated 
using QEMU 

It takes several 
minutes to 
boot up 

The Pi A+ is 


overclocked 


SONS Wind back the clock with this chunky wristwatch 


Michael wants 
to make a Pi 3 


version f Microsoft had designed While he admits the ancient OS Once he'd accrued the required 

TM a smartwatch back in used to drive him mad back inthe components, including a 

working on the late Nineties, it day, he has an odd nostalgia for it. | Raspberry Pi Model A+, it only 

a Robo Skull might have looked something “Many years later you look back took a few hours to put together. 
like this! Michael Darby, aka on it and want to relive it. I think There's a tutorial on his site: 
314reactor, has built a chunky, time has a funny way of keeping magpi.cc/2nX9ss4. The Pi At 
Pi-powered wristwatch running more of the good than the bad sits in the bottom of an Adafruit 
the Windows 98 operating system. within memory.” Pi Protector case with a PiTFT 


2.4-inch HAT touchscreen on top. 
Five tactile buttons have been 
added to the latter, although only 
one is currently used - to shut 
down the system cleanly. The 
watch is powered by a slimline 
LiPo battery connected via a 
PowerBoost 500 with switch, while 
Velcro feet secure the watch body 
to a wrist strap. 

Emulation is employed to get 
Windows 98 working on the 

watch, using the QEMU hypervisor 
running in Raspbian. “Its relatively 
simple," says Michael. *Once 
you've set up a QEMU environment 
on another PC and installed 
Windows 98 to it, it's a case of 
dragging the virtual hard drive 


A LiPo battery, hidden 
underneath, powers the 
Raspberry Pi A* and touchscreen 


Buttons have been added to the 


PiTFT screen, although only one 
is currently used 


Emulated using QEMU, Windows 
98 really works, albeit slowly 
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Remember this? The classic ‘flying windows’ screensaver 


file over to the Pi and running 
it there.” 

When the Windows 98 system 
eventually boots, it really does 
work, although Michael admits 
it’s too slow to be usable and 
touchscreen navigation is tricky. 
“T need to look into calibration, 


virtual graphics card on QEMU on 
the Pi that will allow Windows 98 
to run in 8-bit colour.” 

While Michael has considered 
using a Pi Zero for the watch, 
he has a different plan for an 
upgraded version: “It could be 
made marginally slimmer with a 


I can potentially put a bigger 
screen on and have multiple 
operating systems selectable 


think, or it could be an issue 

with the way QEMU works when 

aunched from the command line.” 
Even so, Michael is eventually 

hoping to get classic 3D shooter 

Doom running on the watch, once 

he’s overcome a technical issue: 

“I can’t find a way to create a 


An AdaFruit 2.4” PiTFT touchscreen, 
with added push buttons, is mounted 
on the Pi 
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Pi Zero and it would give a bit of 
a speed boost... I am thinking of 
going the other way, though, and 
using a Pi 3 in future.” Although 
this would be even bulkier, it 
would run a lot faster as the Pi 3 
handles emulation far better. *T 
can potentially put a bigger screen 
on and have multiple operating 
systems selectable from the 
buttons, such as 95, XP, and even 
something out there like ReactOS 
or some random Linux distro." 

In the meantime, Michael 
has received plenty of positive 
feedback for his Windows 98 
Watch, which he wore to Raspberry 
Pi’s Fifth Birthday Bash. “The 
reaction has been crazy; I never 
expected it to take off like it did, 
but I’m very happy it did and it has 
inspired me to create more and 
work harder.” 
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A Camera Module scans the printer 
order as it comes through. This 
scan is used to provide a backup 


The Raspberry Pi, housed inside 
the box, hosts an Apache web 
server to provide web access 


» Waiting staff 
use an Amazon 
Fire HD to 
take orders 


» The Khyber 
Tandoori is 
a 50-seater 
restaurant 


» The online 
system took 27 
orders in its first 
two weeks 


» The EPOS 
system has 
been in use for 
eight months 


» Customers get 
live updates on 
waiting times 
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ORDER 


How one Indian restaurant used Raspberry Pi 
to automate its whole kitchen ordering system 


help at my father’s 

restaurant on Friday and 

Saturday evenings,” says 
Ehsan Rahman. 

That establishment is the 
Khyber Tandoori, an Indian 
restaurant based in Kingswood, 
Surrey (magpi.cc/2miqcqv). 
Thanks to the Raspberry 
Pi, it has become a highly 
automated environment. 

Two years ago, Ehsan became 
frustrated at writing orders on pen 


and paper. Ehsan’s answer was to 
code and hack his way out. 

The result is PiOrder, a fully 
automated EPOS (electronic point 
of sale) system. PiOrder comprises 
Raspberry Pis, several Pi Camera 
Modules, and a Pipsta thermal 
printer (magpi.cc/2miwYMQ). 

The waiting staff use large Kindle 
Fire tablets to take orders. Two 
smaller tablets are kept near the 
phones so staff can take orders 
over the telephone. 


The Pipsta printer is used to print 
out the order. The kitchen staff tear 
off the order and cook the food 


In the kitchen is a Raspberry Pi 
board hosting the Apache website. 
A program written in PHP and HTML 
is used to provide the webpages. 

Apache is used to host the 
webpage used by the waiting staff 
to take orders. It also offers online 
ordering for takeaway customers. 

Chefs are alerted to new orders 
via a speaker attached to the 
Raspberry Pi. 

The Pipsta printer also prints 
a hard copy of the order, and a 
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Raspberry Pis with Camera Modules 
provide CCTV for the restaurant, which 
can be viewed using the system 


Camera Module takes a photograph 
of the order to ensure it has 
printed out correctly (and to act as 
a backup). More Camera Modules 
are used by managers to keep an 
eye on how busy the kitchen is. 

As well as making Ehsan’s 
waiting duties easier, PiOrder 
saves on costs. “Just Eat charges 
approximately £699 + VAT just for 
signing up,” reveals Ehsan. Then 
it charges around 11% per order, an 
amount that rapidly racks up. 

More importantly, “we have 
control over our software and order 
flow,” adds Ehsan. 


the system has “been resilient.” 
There’s an automated test every 
day at 5:30 for a single popadom, 
“so the chefs and waiting staff 
know the system is up and 
working,” explains Ehsan. 

There are even spare Raspberry 
Pi boards in case of failure. “But 
I've not needed them yet after two 
years," Ehsan reveals. 

As a result of all this tinkering, 
the restaurant is incredibly high- 
tech. As well as the ordering 
system, they are using Raspberry 
Pi Model B boards as smart CCTV 
cameras. Ehsan has even set up a 


The chefs would not go back 
to reading handwritten orders 


ever again 


The system is a mixture of PHP, 
JavaScript, and jQuery, with Bash 
scripting used to communicate 
between the Raspberry Pis. *The 
great thing about Unix files is just 
how reliable they are," says Ehsan. 
The other waiting staff and 
Ehsan's father have completely 
stopped using pen and paper. 
There were some teething 
troubles: the original WiFi 
system occasionally dropped 
the connection, and the Pipsta 
struggled to print large orders. 
But after sorting those issues, 
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Raspberry Pi 3 to act as a remote 
monitoring system, “so my father 
can see how busy the restaurant is 
from home.” 

Ehsan isn't finished. He plans 
to enable customers to order 

food from their table using a 
smartphone or tablet. 

“The chefs and my father were 
not convinced at first, but slowly 
they saw the benefit." The waiting 
staff love the ability to update 
orders with just a few taps. And the 
chefs would not go back to reading 
handwritten orders ever again. 


Online Orders 
ng Time: 20 min - 21:28:22 


il Today: 0 


ders Printed 
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Audio from the four Pi Zeros’ 
USB sound cards is sent to an 
external amp and speakers 


Arcade buttons are used in 
place of traditional piano keys 


» The Tough 
Pi-ano has 48 
'keys' in total 


» Itwill be used 
for music 


therapy 


» The keys are 
plastic arcade 
buttons 


» APi Zero 
controls 
each octave 


» The USB sound 
cards cost 
$0.99 each 
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A layer of smooth plastic protects 
the keyboard and its user 


TOUGH PI-ANO 


Hammer the keys on this incredibly robust musical instrument 


rian McEvoy wanted 
to make a toughened 
electronic keyboard for his 


cousin, who has Down’s syndrome: 


“He loves music therapy but he 
breaks pianos on a weekly basis.” 
Brian’s aunt asked him to help 
with therapy devices for his cousin 
and other such kids. “The idea was 
exciting because there is a whole 
different mindset when designing 
for someone who will not handle 
things with gentle hands. These 
projects have to absorb damage 
without hurting anyone.” 

The result is the Tough Pi-ano. 
It has no exposed metal, and the 
keyboard area is covered with thick 
plastic. For its keys it uses arcade 
buttons, which are inexpensive and 
easy to replace. Each of four octaves 
is powered by a Pi Zero, with a USB 
sound card outputting the audio to 
an external amplifier and speakers. 


While Brian contemplated 
the Tough Pi-ano's design for 
two years, it only took him a 
couple of weeks to build, putting 
his woodworking skills to 
good use. “Keeping everything 
simple was integral to making 
a solid structure." Since the 
original design concept was for a 


SS 


Twelve arcade buttons are wired 
to each Pi Zero, via a resistor board 


perfect piano replica with easily 
replaceable octaves, he started 
crafting wooden piano keys. After 
experiencing too many problems, 
however, these were replaced 
with plastic arcade buttons. “In 
the end, arcade buttons were the 
best solution since they were easy 
to source and replace.” 
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Brian wrote a Python program 
using the Pygame library to read the 
arcade button presses and play WAV 
piano samples. While he considered 
adding a 3.5mm jack to each Pi Zero, 


In the end, arcade buttons were 
the best solution since they 
were easy to source and replace 


he eventually opted to use cheap 
USB sound cards to output the audio. 
The biggest problem was electrical 
noise. “The first octave I built 

didn’t have any pull-up resistors 


TOUGH PI-ANO 


Projects 


MAKEA 
TOUGH PIANO 


on the keys so they were, of course, 
prone to floating. At that point, I 
had inadvertently built a touchless 
piano,” recalls Brian. 1K resistors 
were added to each input to solve 
the problem. “There is still some 
noise on the audio despite using a 
clean power supply and line filter. 
Maybe using $0.99 USB audio cards 
is to blame.” 

While Brian admits it would 
have been possible to use a single 
Raspberry Pi and remote I/O to 
power the piano, the use of one Pi 
Zero per octave has some benefits: 
“If any part was to break, it would 
be possible to shuffle working 
hardware around for a three-octave 
Tough Pi-ano, at least until repairs 
could be made. So there is still an 
advantage to the redundancy.” 

Brian’s Tough Pi-ano is now set to 
be used in his aunt and uncle’s new 
centre for local families with kids on 
the autism spectrum and those with 
Down’s syndrome. While he doesn’t 
plan to build another piano, he has 
some advice for would-be makers. 
“T would recommend building the 
speakers into the enclosure, but 
be sure to ventilate the amplifier. 


\ 


2 


Also, buy one of the tools used to 
fasten arcade button washers, or 
you'll regret it when you get to the 
50th button and your knuckles 

are bloody.” 


The 1K resistor 
boards were 
added to reduce 
issues with 
electrical noise 


e^sooes 
Memkem onore 


o 
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Get off to a good start with Minecraft: Pi Edition. 
Play the game and write your first program using the API. 


The mouse changes where you look 

Holding the left button destroys blocks 

Right button places blocks 

W, S, A, D move you forward, backward, left, 
and right 

1, 2, 3, 4, 5, 6, 7, 8 change what you are holding 
E opens the inventory 

ESC takes you back and to the Menu 

SPACE is jump. Double-tapping it makes you fly 
or stop flying 


ello Minecraft Ha rid 


Get the player’s position 

Change (or set) the player’s position 

Discover the type of block at a specific location 
Change a block 

Change the camera angle 

Post messages to the player 


Go to the Minecraft menu with ESC, but leave 
the game running (you can minimise it). 
Open IDLE by clicking Menu > Programming > 
Python 3 (IDLE). 
Use File > New File to create a new program and 
save it as hellominecraftworld.py. 

At the top of your program, type the following 
code to import the minecraft module, which 
will allow you to use the API and talk to the game: 
import mcpi.minecraft as minecraft 

On the next line, create a connection from your 
program to Minecraft and call it mc: 

mc = minecraft.Minecraft.create() 

Use your Minecraft connection and the 
function postToChat() to put a message in 
the chat window on a third line: 
mc.postToChat("Hello Minecraft World") 
Run your program by clicking Run » Run Module. 


— 


All blocks in 
Minecraft have a 
position of X, Y, Z 


WATCH FOR 
RED TEXT 


PYTHON 


IS CASE- 
SENSITIVE 


Teleport the player by setting their position: 
mc.player.setPos(0, 50, 0) 

Run your program by clicking Run » Run Module. 
Quickly switch back to Minecraft to see your 
player fall to the floor (unless in flying mode). 


Tutorial STEP BY STEP 


> GPIO Zero 


> 1x solderless 
breadboard 


> 1x light- 
dependent 
resistor (LDR) 


> 1x 1uF capacitor 
> 1x laser pointer 


» 5x male-to- 
female jumper 
wires 


» 5x female-to- 
female jumper 
wires (optional) 


» 1x drinking straw 


» 1x plastic box 
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PHIL KING 


When not writing and sub-editing 
on The MagPi, Phil loves to work on 
Pi projects. This article is based on 
an official resource by Marc Scott. 
@philking68 @Coding2Learn 


The light-dependent 
resistor (LDR) has 
lower resistance 
when the laser is 
shining onto it 


By timing how long it 
takes to charge the 
capacitor, we can 
work out the light 
level on the LDR 


Asimple piezo 
buzzer is made to 
beep whenever the 
laser tripwire beam 
is broken 


Learn how to use an LDR to detect a laser pointer beam 


he Raspberry Pi can easily detect a digital 

input via its GPIO pins: any input that’s 

approximately below 1.8V is considered off, 
and anything above 1.8V is considered on. An analogue 
input can have a range of voltages from OV up to 3.3V, 
however, and the Raspberry Pi is unable to detect 
exactly what that voltage is. One way of getting around 
this is by using a capacitor, and timing how long it 
takes to charge up above 1.8V. By placing a capacitor 
in series with a light-dependent resistor (LDR), the 
capacitor will charge at different speeds depending on 
whether it is light or dark. We can use this to create a 
laser tripwire! 


Place your laser tripwire across a doorway; 
when someone breaks the beam, the alarm will sound 


Connect the LDR 

An LDR (also known as a photocell) is a special type of 
electrical resistor whose resistance is very high when 
it’s dark, but reduced when light is shining on it. With 
the Raspberry Pi turned off, place your LDR into the 
breadboard, then add the capacitor. It’s essential to 
get the correct polarity for the latter component: its 
longer (positive) leg should be in the same breadboard 
column as one leg of the LDR. Now connect this 
column (with a leg of both components) to GPIO 4. 
Connect the other leg of the LDR to a 3V3 pin, and the 
other leg of the capacitor toa GND pin. Your circuit 
should now resemble the diagram above. 


Test the LDR 

On the Pi, open IDLE from the Main Menu: Menu 

> Programming > Python 3 (IDLE). Create a new 

file by clicking File > New File, enter the code from 
ch8listing1.py, then save it. At the start, we import 
the LightSensor class from GPIO Zero. We then 
assign the variable 1dr to the LDR input on the GPIO 4 
pin. Finally, we use a never-ending while True: 
loop to continually display the current value of the 
light sensed by the LDR, which ranges from 0 to 1. Try 
running the code and then shining your laser pointer 
on it to vary the light level. 
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Above Shining the laser onto the LDR in a darkened room will 
dramatically affect the measured light level 


>STEP-03 

Enclose the LDR 

Unless you're working in a darkened room, you'll 
probably notice little difference between the measured 
light level when the laser pointer is directed onto the 
LDR and when it's not. This can be fixed by reducing the 
amount of light that the LDR receives from other light 
sources in the room, which will be essential for our laser 
tripwire device to work effectively. We'll achieve this 

by cutting off a short section - between 2cm and 5cm - 
of an opaque drinking straw, and inserting the head of 
the LDR into one end. Now try the test code again and 
see how the measured light level changes when you 
shine the laser pointer into the other end of the straw. 
You should notice a larger difference in values. 


>STEP-04 

Wire up the buzzer 

To create an audible alarm for our laser tripwire, we'll 
add a piezo buzzer to the circuit. Again, the polarity 
has to be correct: connect the column of the buzzer’s 
longer leg to GPIO 17, and the shorter leg toa GND 
pin. Let’s test whether it is working. In IDLE, create 

a new file, enter the code from ch8listing2.py, and 
save it. At the top, we import the Buzzer class from 
GPIO Zero. Next, we assign the buzzer variable to 
the buzzer output on GPIO 17. Finally, we use 
buzzer. beep to make the buzzer turn on and off 
repeatedly at the default length of one second. To stop 
it, close the Python shell window while it is off. 


>STEP-05 

Test the tripwire 

We'll now put it all together so that laser pointer shines 
at the LDR through the straw, and whenever the beam 
is broken, the buzzer sounds the alarm. In IDLE, create 
a new file, enter the code from ch8listing 3.py, and save 
it. Atthe start, we import the Buzzer and LightSensor 
classes from GPIO Zero. We also import the sleep 
function from time; we'll need this to slow the script 
down a little to give the capacitor time to charge. As 
before, we assign variables for the buzzer and LDR to the 
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© chóliatingl.py 


MAKE A LASER TRIPWIRE 


from gpiozero import LightSensor 
ldr - LightSensor(4) 


while True: 
print(ldr.value) 


from gpiozero import Buzzer 


buzzer = Buzzer(17) 
buzzer.beep() 


ch8listing3.py 


from gpiozero import LightSensor, Buzzer 
from time import sleep 


ldr = LightSensor(4) 
buzzer = Buzzer(17) 


while True: 
sleep(0.1) 
if ldr.value « 0.5: 
buzzer.beep(0.5, 0.5, 8) 
sleep(8) 
else: 
buzzer.off() 


respective devices on GPIO pins 4 and 17. We then usea 
while True: loop to continually check the light level on 
the LDR; if it falls below 0.5, we make the buzzer beep. 
You can change this number to adjust the sensitivity; 

a higher value will make it more sensitive. Try running 
the code. If you break the laser beam, the buzzer should 
beep for eight seconds. You can adjust this by altering 
the buzzer . beep parameters and sleep time. 


>STEP-06 

Package it up 

Once everything is working well, you can enclose your 
Raspberry Pi and breadboard in a plastic box (such as 

an old ice cream tub), with the drinking straw poking 
through a hole in the side. If you prefer, you can remove 
the breadboard and instead connect the circuit up 
directly by poking the legs of the components into 
female-to-female jumper wires, with the long capacitor 
leg and an LDR leg together in one wire end, connected 
to the relevant pins. Place the tub near a doorway, and 
place the laser pointer on the other side, with its beam 
shining into the straw. Run your code and try walking 
through the doorway: the alarm should go off! 


>PYTHON 3 


DOWNLOAD: 
magpi.cc/2bhxwxC 
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.. CLIVE WEBSTER 


> Dash Buttons 
magpi.cc/ 
2mUKaqT 


> Asmart thing 


> Some patience 
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A professional tinkerer since 2004, 
Clive just keeps seeing more uses 
for Raspberry Pis around the house. 
How many Pis is too many? 
@clivewriting 


£5 for a WiFi 
smart button? 
Yeah, we'll 
have seven 


Buy different 
buttons so you 
can identify 
which is 

which later 


You'll need a 
low-power, 
always-on 
computer 
with wireless 
- that's the 
definition of 
a Pi Zero W 


AN AMAZON 
DASH BUTTON 


Rescue Amazon’s £5 smart button from the monotony 
of ordering loo roll, and use it to do anything you like. 


he Internet of Things has two flaws: the name, 

and the need to get your phone out of your 

pocket, unlock it, swipe to the appropriate app, 
and wait for the app to load before you can do perform 
a basic task, such as turning on a light. Buttons are 
handy for a reason: they're exactly where they need to 
be, and you can just press them. So if we're going to 
have smart things, we need smart buttons. 

Typically these cost £40, but Amazon's Dash Button 
costs a fiver. With a little tinkering and subversion, it 
can power anything from smart bulbs to alerts on your 
family's smartphones to logging your billable hours. 

Head over to Amazon to buy some Dash Buttons 
(you'll need to be a Prime subscriber) and you'll be 
baffled by the options: you can emergency-order raw 
virgin coconut oil (only £16.62 for 1.2kg), 20-sheet 
binding machines, or Nerf Darts with a Dash Button. 


The catch with these Dash Buttons is that you can 
only order certain products from certain firms. This 
matters, as Amazon will discount the price of a Dash 
Button from the first purchase made with it. Make 
sure you buy a button that lets you order something 
you'd buy anyway; that way, your Button is free. 
Once the Dash Button arrives, use the Amazon 
app (Android and iOS only) to set it up and order 
that first item. There are decent instructions at 
amzn.to/2mNhAqt. Once you've ordered your 
product, go back into the Dash Devices and disable 
it. Then - bear with us - enable the Button again, but 
this time don't select a product. Instead, just quit the 
app (don't quit the process, close the whole app). This 
will have copied your WiFi credentials to the button 
without re-establishing the link to Amazon. It is now 
an unshackled smart button ready to be repurposed. 
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Jessie games 

We used Jessie Lite on our Raspberry Pi Zero W, as 

it will be running as a headless server with no GUI 
required. Once in, follow the usual update procedure: 
sudo apt-get update && apt-get -y dist- 
upgrade. As your Dash Button has already accessed 
your router, its MAC address should be listed in your 
router’s logs or DHCP tables. The location differs 
according to manufacturer. The button will show up 
as ‘Internet Device’ or similar. 

Now we're ready to code. The idea behind this hack 
is to use the Pi as an interpreter. It constantly monitors 
your network for the appearance of the Dash Button, 
then uses that appearance as a trigger for some other 
action. We're going to use Python to intercept those 
button presses, but this requires an extra module: 


sudo apt-get install -y pip 
sudo pip install scapy 


Pip is a Python-specific installer, and Scapy is the 
module we'll use to ‘sniff? for the Dash Button's MAC 
address (pkt [ARP] . hwsrc) appearing on the network. 
As the Dash Button only powers up when you press 
its button, its MAC address will only appear after 

a button press. 


Button whole 

Now that we can intercept a button press, let's do 
something with it. We've got a LIFX smart light, so 
we need the LifxLAN Python module: pip install 
lifxlan. Open the trigger script and add the LifxLAN 
module's functions to the script with the line from 
lifxlan import *. 

Now we need to find the MAC and IP address of the 
smart bulb from our router, and to name the bulb in the 
Python script using the ‘Light’ object of the LifxLAN 
module: bedroom = Light('xx:Xx:Xx:XX:XX:XX' , 
'192.168.1.xxx' ). We need to find the current power 
level of the bulb in order to toggle it, which we do with 
the current state = bedroom.get power() variable 
and the bedroom.set power() commands of our if, 
else statements. Annoyingly, the Dash Button sends 
two ARP packets every time it is pressed, so we need to 
ignore the second ARP packet by using the second arp 
Boolean variable. 

Once done, save your script, make it executable 
(chmod +x lights.py)and add it as a cronjob 
(crontab -e) to make sure it runs every time your Pi 
boots: @reboot sudo python /home/pi/lights. py. 

Now we’ve got a smart button that we can stick to any 
wall, table, desk or bookcase to turn on our smart lights. 
And if a LIFX bulb sounds steep at £60 each, it would 
cost a lot more to install a new ‘dumb’ light switch once 
you've factored in gouging cable runs in the wall, hiring 
plasterers to make good and repainting a whole room 
or hallway. People have made Dash Buttons work with 
Philips Hue and Samsung SmartThings devices, too. 
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HACK AN AMAZON DASH BUTTON 


trigger. py 


from scapy.all import * 


>PYTHON 


DOWNLOAD: 


magpi.cc/ 
DashButtonCode 


def arp_detect(pkt): 
if pkt[ARP].op == 1: #network request 
if pkt[ARP].hwsrc == 'Xx:xx:XX:XX:XX:XX' 
return "Button detected!" 


print sniff(prn=arp_display, filter="arp", store=@) 
EXAMPLE CODE 


lights.py 


from scapy.all import * 
from lifxlan import * 


Buttons 
andrex - 


XO OU OX XO 


#Lights 
bedroom = Light('xx:xx:XX:XX:XX:XX' , 
second_arp = False 


2192:168:51::9005) 


def arp detect(pkt): 
if pkt[ARP].op == 1: #network request 
if pkt[ARP].hwsrc -- andrex: 

current state = bedroom.get power() 

if current state -- 
bedroom.set power("on" 

else: 
bedroom.set power("off") 


if second arp -- False: 
sniff(prnzarp detect, filter="arp", store-0) 
second arp - True 

else: 
second arp - False 


Shoot for the (Button) Moon 

So, what else could you press your Dash Button to do? 
Hook your Python script into an online spreadsheet and 
you can log the time between button presses - useful 
for a musician logging practice sessions, or a freelance 
accountant logging billable hours. Tired of shouting 

up the stairs for your kids to come down for dinner? 
You could go the JavaScript route to connect an SMS 
messenger: press your Dash Button and they'll receive 
atext message (magpi.cc/2mt3zmo). Or use a service 
like Pushover (pushover.net) to make a smart doorbell, 
sending alerts to your smartphone or watch. 

Aaron Bell has detailed how to make a hacked Dash 
Button into an IFTTT trigger (magpi.cc/2msVvC5). 
We'd also thank Ted Benson for being one of the first 
Dash hackers (magpi.cc/2msUzhh), although updated 
Amazon firmware is incompatible with his code. 
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ADDA 


TONY HANSEN 


Tony is an ‘experienced’ software and 
computer engineer, meaning he's been 
doing this for quite some time. He 
rediscovered his love for the smell of 
solder a few years ago. 
magpi.cc/2nCOVrA 


TO POWER DOWN 


YOUR 


Add a switch to your Raspberry Pi to safely shut it down without pulling the power 


o keep prices down, the Raspberry Pi is missing 
something that most electronic devices come 
with: a switch to turn it on and off. That's 
OK, you say, we'll just pull the plug to turn it off. 
Unfortunately, this can lead to corruption problems with 
the SD card. All the instructions say you should run the 
shutdown command before pulling the plug, but this is 
» Momentary push : ! 
button switches not always possible, particularly when your Raspberry 
such as: Piis running headless without a connected keyboard 
magpi.cc/ and monitor, and possibly even without a network 
20CMKCm i : 
connection. So, what can a self-respecting DIYer do? 
The answer, of course, is ‘add your own switch’! 
Lots of articles are available to tell you how to 
use a breadboard to connect a button or LED to a 


Momentary switch connected 
to pins 39 and 40 


Right-angle header 
pins soldered and 
ready for a reset switch 


» Raspberry Pi 
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Raspberry Pi’s GPIO pins. This article focuses on doing 
something useful with those switches and LEDs. 

The safe off-switch is complementary to a reset 
switch, which is the best method for starting the 
Raspberry Pi up again. Issue 52 of The MagPi featured 
an excellent article on how to connect a reset button. 


Using GPIO Zero 

With the GPIO Zero library, the Python code to deal 
with a button press becomes extremely simple. 
Assuming your button is connected between GPIO 21 
and GND (ground), the code is nice and easy. 

You can download it from magpi.cc/2nD29F7 as 
shutdown-press-simple.py. 

This code creates a button on GPIO 21, waits for it 
to be pressed, then executes the system command to 
power down the Raspberry Pi. GPIO 21 is nice because 
it's on pin 40 of the 40-pin header and sits right next to 
a ground connection on pin 39. This combination makes 
it difficult for an off-switch to be plugged in incorrectly. 
On a 26-pin header, GPIO 7 is similarly situated at the 
bottom, on pin 26, next to pin 25's ground connection. 

Create the script on your Raspberry Pi using your 
favorite text editor (e.g., nano, Vim or Emacs), as in: 


$ nano -pi/shutdown-press-simple.py 


Then add a line to the end of /etc/rc.local to run 
it at boot time: 


$ sudo su 
# echo "~pi/shutdown-press-simple.py &" >> / 
etc/rc.local 


Now, after rebooting, your script will be running 


and listening for a button (connected between GPIO 21 
on pin 40 and ground) to be pushed. 
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* Complementary reset switch 


Preventing accidental button pushes 
One major drawback of the previous code is that any 
accidental push of the button will shut your Raspberry 
Pi down. It would be better if you needed to hold the 
button down for several seconds before everything 
powers down. Check out shutdown-with-hold. py. 

Instead of hard-coding the GPIO number 21 and 
the hold time, this code does a few things differently. 
First, it defines variables to hold these numbers at the 
top of the code. For a program this small, declaring 
the values at the top is not necessary, but it is good 
practice to declare any configurable variables near 
the top of the code. When making changes later, you 
won’t have to hunt through the code to find these 
variables. Secondly, it allows the GPIO number and 
hold time to be overridden on the command line, so 
that you can change them later without modifying 
the program. 

We then define a function named shutdown() to 
execute the poweroff system command. The button 
is also assigned to a variable for use in the next 
statement. This time, we are also specifying that the 
button must be held down, and when the hold time 
(6 seconds) has passed, any function assigned to the 
when_held event will be executed. We then assign 
that event to the shutdown() function we defined 
earlier. The call to pause() is needed to cause the 
script to wait for the button presses. 

If you look at the examples that come with the 
GPIO Zero source, you'll find a script very similar to 
this one (magpi.cc/21ANxVA). 


Feedback while pressing the button 
We can do better. The major thing lacking with the 
above code is any sort of feedback. It is hard to tell 
that anything is really happening while you have the 
button pressed down. Fortunately, GPIO Zero allows 
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us to do much more with a button press, such as 
turning an LED on and off or setting it blinking, by 
attaching this to the button's when pressed event. 
We need to ensure that the LED is turned off if the 
button is not held down for the entire length of 
time. This can be accomplished by attaching to the 
when released event. 

As before, the important work has been moved into 
functions named when pressed(),when released(), 
and the same shutdown( ) function we used before. 
These are assigned to their corresponding button events. 


Going further 
Can you think of other ways to provide feedback while 
pressing the hold button, or alternative ways to signal 
that it is time to turn off? How about using a buzzer, 
or popping up a message on a screen? You could also 
use the on-board activity LEDs, making them blink 
faster and faster as it gets closer to shutdown time. 
Or even play an audio clip, such as "I'm melting". The 
GitHub repository contains additional examples such 
as these. How about watching the ‘low battery’ signal 
from a battery pack as a signal to shut down? Let your 
imagination run wild. 

Now, which of your projects are you going to add 
shutdown and reset buttons to? 


>PYTHON 


DOWNLOAD: 
magpi.cc/2nD29F7 


Left Example of 
both an off and 
reset switch on 

a Raspberry Pi 
Zero. Right-angle 
headers are used 
for a compact 
connection. 

The switches 

are mounted 
directly onto an 
Adafruit case 
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Tutorial 


> Apple or Android 
mobile device 


> TouchOSC app 


> Raspberry Pi 3 


Create your own cut-out theatre controlled from your mobile device 


he idea for this project is to replicate a cut-out 
theatre using the Raspberry Pi to show your 
production. As the Pi’s screen will display 
the finished performance, that leaves no space on 
the screen for your controls. You might think that 
you could use a keyboard, but that would not provide 
proportional control and would be difficult to drive. 
The alternative, of using external hardware, could 
get expensive. A cheap solution, if you already have 
a smartphone or tablet, is to use that to control the 
theatre. All you need is an interface you can customise, 
and a way to send and receive messages. Enter OSC. 
OSC stands for Open Sound Control, and is an open, 
extendable method of exchanging messages. While 
it was originally designed for sound applications like 
mixers and effects units, it’s flexible enough to be used 


for anything. TouchOSC is an excellent application that 
turns your mobile device into an OSC command-and- 
control station. It is hard to convey how satisfying it is 
to control the performance from a tablet! 


TouchOSC 


While it is not a free app, at less that £5/56 it is not 
very expensive. There are two parts to it: the app 

that runs on your mobile device, and an editor for 
designing the custom control screens on your laptop. 
Go to the TouchOSC webpage at magpi.cc/2nSa69S 

to download the app and the editor. There are plenty 
of controls on offer, including faders, pads, rotary 
controls, and push buttons. Follow the instructions in 
‘Creating the custom performance’ to create a simple 
custom interface for this project. 


The wolf approaching Grandma 
Tablet controlling the performance 


Position of the Wolf 


OSC messages 
Each OSC message consists of two parts: an address and 
a payload. The address part is identical to the path of a 
file on the Pi, the only difference being that there are 
no directories, and you can build your own hierarchical 
structure to suit your own needs. On TouchOSC, each 
window can have a number of tabs, each tab bringing 
up a different screen. The first default hierarchical 
level is the tab number, preceded by a forward slash. 
There is only one screen for this project so all messages 
start with /1. The next level defines the control device, 
so a fader might have the address /1/fader1, or a push 
button /1/push4. That is as far down the hierarchy as 
we need to go for this project, but you can go further if 
you need to. The payload is the data that is delivered 
to that address, and can be in the form of an integer, a 
floating point number, text, or a Boolean logic value. 
When you send a message, you have to specify both the 
address and the payload. 
At the receiving end, the message address is 
normally parsed to see how to apply this number to 
the program you want to control. In our application, 
the payload will be used to move graphics around 
on the screen. You can send messages back to the 
TouchOSC controller, where they can be used to 
change the controls without user intervention, or to 
add feedback or acknowledgement of commands. 


Implementation 

We did hope to implement the OSC messages 

in Python, as there are a few libraries to do this. 
Unfortunately this proved impossible, because the 
ones we tried had poor documentation that was out 
of date, and either fell over when trying to cope with 
three faders, or required complex multithreading 
programming with no practical examples available 
online. Instead, we turned to Processing, which has 
a simple and reliable interface for incoming OSC 
messages. We used Processing in the Ribbons project 


Tutorial 


DOWNLOAD: 
magpi.cc/1NqJjmV 


Check out Mike's 
Bakery videos at: 
magpi.cc/1NqJnTz 


Enabled 

Host 

Port (outgoing) 
Port (incoming) 


Local IP address 


in The MagPi #49, but in case you didn’t install it then, 
it can be installed from a command line by typing: 


curl https://processing.org/download/ 
install-arm.sh | sudo sh 


After reboot, it'll then appear in the Raspbian menu 
under Programming. As with all network programs, 
you need to configure everything for your setup. 

In this case you only need two IP addresses. In the 
Processing code you need the IP address of the tablet, 
and on the tablet you need to set the IP address of the 
Raspberry Pi. This is shown in Fig 1. As in a network, 
the IP address can change from day to day, and it can 
be tedious always having to change the configuration 
before anything will work. You can get round this by 
accessing your router and telling it to always give a 
fixed IP address to both your Pi and your tablet. 


€. 


192.168.1.71 


7000 
7001 


192.168.1.69 


The theatre 


The theatre is simply a collection of graphics for the 
backdrops, props, and actors. These ware taken mainly 
from the story of Little Red Riding Hood in the Boston 
Sunday Globe of 1895. Curiously, this did not include an 
axe-carrying woodsman for the final scene, so we had 
to take one from another story and eliminate his wife by 
judicious use of the clone tool in our photo processing 
package! Fig 2 shows the results of this process. 

There are two actors in this story, and each one has 
its own slider control. Each actor also has a number of 
different costumes, with Riding Hood, in an amazing 
show of virtuosity, also playing the part of the 
woodsman, and Grandma’s head. This saves on sliders 
and makes the control panel cleaner. There are two 
‘heads’ for Grandma: one for talking to the Wolf, and 
the other for when the Wolf is pretending to be her. 
The movement controlled by the sliders is restricted 
to a simple nod, which is operated by tapping on 
opposite ends of the slider. 

The elements are stacked up in a fixed order from 
back to front, defining what will show in front of 
what. A more complex setup could control this order, 
at least for the actors and props, but we're keeping 
things simple. The main task in adapting the graphics 
is to isolate the elements against a transparent 
background. You need to use a PNG type file and not 
aJPEG to define the transparent part. The image 
files must be placed inside the data subfolder of your 
Processing sketch's folder, in the sketchbook folder. 


The software 

The structure of the Cutout_Theater.pde sketch is 
quite simple. The Draw function runs repeatedly, and 
if a change has been signalled by the DisplayUpdate 
variable, it draws the new window. This prevents a lot 


Removing the wife with the clone tool. It doesn't work in real life 


of unnecessary drawings when nothing has changed. 
The Setup function defines the ports used for the OSC 
messages and loads in all the individual images. By 
far the longest function is oscEvent, which handles 
the incoming messages. This looks in turn at the two 
active control elements, push buttons and faders. The 
push buttons work as toggle buttons for the props 
and background by sending back a confirmation of 
the push, and fixing the colour of the button. This 
shows you that a message has got through, because 
occasionally OSC messages, like all slip-formatted 
messages, can go astray. The actors’ costume buttons 
are implemented as radio buttons, so you can’t have 
more then one selected at a time. The controls for the 
faders simply pass on their value to the appropriate 
variable. This is all that is needed because the range of 
the fader has been defined in the TouchOSC setup. 

When the program first starts, the curtain is closed. 
A message is sent to the tablet to move the faders to 
reflect this. The initial elements for the first scene are 
also set up. There are a few other small functions that 
help with the parsing. 


Taking it further 


You can set up another play with your own characters, 
and once you see how it works, change the controller 
to cope with more variables. However, be careful not 
to make the control too cluttered. You could use some 
controls to trigger sound effects or animations, like 
the curtain automatically rising, or a prop falling over. 
You can replace the slider controls for the actors with a 
small XY pad for flying objects, or to put a bit of bounce 
into a walk. You could replace the single graphic of 

an actor with a sequence to show things like walking. 
Finally, you can add special effects, like lightning 

or a character dissolving in a teleporter. 


/1/fader2 Range -240 to 900 


/1/push1 /1/push2 /1/push3 


/1/push4 /1/push5 /1/push6 /1/push7 


/1/fader3 Range -240 to 900 


Normal 


/1/pus 


/1/pus 


/1/pus 


/1/pus 
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/1/fader1 


Range 0 to -580 


MULTIPROCESSING 
WITH PYTHON 


Power up your Pi from Python by running loops in parallel 
using the multiprocessing module (fractals are included) 
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Right An image 
of the entire 
Mandelbrot set, 
as produced 

by the program 
mandelbrot.py 
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odern computers are good at multitasking. 

Quad-core devices like the Pi 2 and 3 can share 

work between their cores, and your programs 
can run up to four times faster if you know how to code 
them in parallel. However, this is not always easy. 
Programming languages like Python are sequential, 
executing instructions one at a time. What if you 
want to use all four cores? Luckily, there is help from 
the multiprocessing module, which allows parts of 
your program to run in parallel. To demonstrate how 
it works, we will adapt a program so that its central 
part runs in parallel, creating some beautiful fractal 
images in the process. First, you may need to install 
the matplotlib module, using: 


sudo apt-get update 
sudo apt-get install python-matplotlib 


0 


200 


800 


1000 


Embarrassingly parallel fractals 

The program mandelbrot. py plots an image of the 
Mandelbrot set, which has an infinitely complex shape 
based on a Surprisingly simple mathematical rule. At 
its core, it performs a simple but potentially expensive 
calculation for every pixel. These calculations are all 
independent, so they can be run in any order or in 
parallel (this is called an ‘embarrassingly parallel’ 
problem). Take a look at the program. The work is done 
by a pair of nested for loops (labelled ‘main loops’) 
which call the function mandelbrot ( ), defined a few 
lines earlier, for each pixel in the image. This is the 
time-consuming part. As with all basic loops in Python, 
the calculations are performed sequentially, or one at 

a time. Try running the program from the command 
line (unfortunately, multi-process programs cannot be 
launched from IDLE): 


python mandelbrot.py 


It should generate a Mandelbrot set image like the 
one on the left. You can resize it and use the controls 
on the bottom left of the window to zoom and examine 
itin detail. This program uses only one processing 
core and runs in about 40 seconds on a Pi 3. We would 
like to run the main loops in parallel. This is relatively 
simple, thanks to multiprocessing. 


Introducing multiprocessing 
Before we can parallelise the loops, we need to make 
a small change. Replace the main loops with: 


Z 


[complex(x,y) for y in Y for x in X] 
map(mandelbrot, Z) 
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Now run the program again. It should take a similar 
amount of time to run. What has changed? Instead of 
calling the mandelbrot() function many times within 
the nested loops, we now build up a list of arguments 
for these calls in advance (Z) and use the built-in 
map() command to call the function on each entry in 
the list, placing the results in a new list (N). This does 
exactly the same thing as before, but our code is now 
in a form that we can parallelise more easily. Add the 
following line at the top of the program: 


from multiprocessing import Pool 


and change the main loop section to: 


p = Pool() 
Z = [complex(x,y) for y in Y for x in X] 
N = p.map(mandelbrot,Z) 


This is where multiprocessing works its magic. It 
creates a multi-process pool (p) and uses it to calla 
special version of the map() command. It makes all the 
same calls to mandelbrot() as before, but this time 
the work is split up and distributed in parallel using 
the pool. The number of processes in the pool matches 
the number of cores you have available (four in the 

Pi 2 and 3) by default. The results are collected back 
together into a single list (N) at the end. This program 
should run about twice as fast as before. If you run the 
top command in another Terminal window while the 
program is running, you will see the four extra Python 
processes that make up the pool. We have doubled the 
speed with a very simple change to our code. 


Bunch them up 
Can we do better? It turns out that the calls to 
mandelbrot() are too brief to run efficiently in 
parallel across the pool. For better performance we 
must bunch them together in groups. We can do this 
easily by returning to our two nested loops. For the 
inner loop, which produces the image along a single 
line in the x direction, define this function just below 
the definition of mandelbrot(): 


MANDELBROT SET IMAGES 


The Mandelbrot set is the set of complex 
numbers c for which the function f(z) = z?«c 
does not diverge for increasing z. In our plots, 
each pixel corresponds to a different complex 
number c. For every pixel, we determine 
whether the function diverges by iterating up 
to maxiter times. If we reach maxiter without 
diverging, then the point is deemed to be 
inside the set. Otherwise we record the number 
of completed iterations. Translating these 
numbers to a colour scale gives the patterns 
that we see surrounding the Mandelbrot set. 
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MULTIPROCESSING WITH PYTHON 


mandelbrot.py 


>PYTHON 

from numpy import linspace, reshape 

from matplotlib import pyplot DOWNLOAD: 
magpi.cc/2nD2PtR 

xmin, xmax = -2.0 ,0.5 # x range 

ymin, ymax = -1.25,1.25 # y range 

nx , ny = 31000,1000 # resolution 

maxiter = 50 it max iterations 


def mandelbrot(z): # computation for one pixel 
G 
for n in range(maxiter): 
if abs(z)>2: return n 
Z= Z*z 4€ 


# divergence test 
return maxiter 


X 
Y 


linspace(xmin,xmax,nx) # lists of x and y 
linspace(ymin,ymax,ny) # pixel co-ordinates 


# main loops 


At] 


for y in Y: 
for x in X: 
z = complex(x,y) 


N += [mandelbrot(z)] 


N = reshape(N, (nx,ny)) # change to rectangular array 
pyplot.imshow(N) # plot the image 
pyplot.show() 


def compute all x(y): 
Z = [complex(x,y) for x in X] 
return map(mandelbrot, Z) 


This runs the inner loop sequentially, not in 
parallel. Now, for our main loop, we call this function 
in parallel, spreading the calls across the pool: 


Pool() 
p.map(compute all x,Y) 


zu 
to ou 


This maps the work in larger chunks (whole inner 
loops rather than individual pixels). This program should 
now run roughly four times as fast as the original. 

With some simple changes and the use of 
multiprocessing, we have distributed our time- 
consuming loop over four cores instead of one. Our 
code is still simple and readable, although slightly more 
complex than before. For advanced programmers, there 
are much faster methods of plotting fractal images. 

The graphics processor on the Pi can outperform its 
CPU, as demonstrated by the Mandelbrot set program 
at magpi.cc/2mTVIKY. This program, written in C and 
OpenGL, is much faster than ours, but it is also far more 
complicated and nearly 20 times as long. 
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When 
accessing the 
elements of a 
structure, make 


sure you are 
using the right 


symbol. A . is 
used if your 
variable is an 
instance of the 
structure itself; 
a -> is used if 
your variable is 
a pointer to an 
instance of the 
structure. Using 
the wrong one 
will usually give 
an error from 
the compiler. 


NEW TYPES 
INSIDE 
STRUCTURES 


Astructure can 
contain other 
new types 
(either plain 
types, enums 
or indeed other 
structures). 
Just make sure 
the typedefs 
for them occur 
before the 
typedef of 

the structure 

in which 

you want to 
include them. 


NUMBERED 


ENUMS 


When you 
create an 
enum, the 
compiler 
assigns a 
numeric value 
to each of the 
possible values. 
By default, 

it numbers 
the first in the 
list as o and 
counts up from 
there. You can 
override this 
by putting an 
equals sign 
after each 
named value 
and setting it 
to the value 
you want. 


58 | MagPi May 2017 


AN INTRODUCTION TO C 
MORE ABOUT TYPES 


AND VARIABLES 


Global variables, type definitions, enumerations, and structures 


n this instalment, we are going to look 
at some of the more advanced uses 

for variables and types, including the 
difference between local and global variables, 
defining new types, and the use of enumerations 
and data structures. 

In the examples in this series, we have always 
put variables inside function definitions. These are 
therefore local variables; that is, variables which are 
local to those functions and have no meaning outside 
the function. 


Global variables 

C also allows global variables; that is, variables which 
are defined outside all functions. These have global 
scope, which means that they can be read and written 
from any function within the program. Let's look at 
an example: 


#include <stdio.h> 
int result; 


void add (int a, int b) 
{ 
result = a + b; 


} 


void main (void) 
{ 

add (3, 4); 

printf ("The result is %d\n", result); 
} 


In this example, the variable result is a global. It 
can be read or written within both the add function 
and the main function. We write a value to it in add, 
and read it back in main, so we don’t need to return 
a value from add. 


This looks easier than passing values about all 
over the place, so why not just do this all the time? 
The answer is memory. Local variables in functions 
are temporarily allocated space while the function is 
running, and the memory is freed up as soon as the 
function ends. But global variables are allocated space 
when the program starts, and that space isn’t freed 
until the program ends - if you allocate enough of 
them, you can run out of memory on some systems. 


Type definitions 

In a previous instalment, we looked at the range of 
variable types in C: char, int, float, and so on. C 
also allows you to define your own types, with what 
is known as a typedef. Here's an example: 


typedef unsigned char BYTE; 


This defines a new type called BYTE, which 
is another name for an unsigned char. (It is 
conventional to give user-defined types names in 
capital letters, to distinguish them from variables.) 

When we say this defines a new type, what it really 
does is create an alias to an existing type. This seems 
a bit pointless, but it can help in two ways. First, it can 
make it more obvious what your code is doing if you 
make the type names specific to your program's data. 
Second, by defining specific types, you can get the 
compiler to warn you if you use the wrong type for a 
function argument or variable. 

There are a couple of cases where typedefs are 
particularly useful - these are enumerated types 
and data structures. 


Enumerated types 

Sometimes we want a variable which can only take 
one of a few possible values. C provides a type called 
enum for this purpose, which defines an integer with 
a fixed set of named values. Here's an example: 
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#include <stdio.h> 


typedef enum { 
false, 
true 

} BOOLEAN; 


void main (void) 


{ 
BOOLEAN b_var; 


b_var = false; 
if (b_var == true) 


{ 

printf ("TRUE\n"); 
} 
else 
1 

printf ("FALSE Nn"); 
} 


The named values of the enumerated type are used 
instead of numbers. This can make code easier to 
understand, and is a good way of preventing errors, as an 
enumerated variable can only ever be set to a valid value. 


Structures 

The other useful thing you can do with typedef is 

to use it to define a data structure, a collection of 

individual variables which are grouped together. 
Here’s an example: 


#include <stdio.h> 


typedef struct { 
int inval1; 
int inval2; 
int outval; 

} MY_DATA; 


void add (MY_DATA *d) 
1 


d-»outval = d->inval1 + d->inval2; 


} 


void main (void) 


{ 
MY_DATA data; 


u 
ul 


ve we 


data.inval1 
data.inval2 
add (&data); 


u 
N 


printf ("Xd + Xd = %d\n", data.inval1, 
data.inval2, data.outval); 


} 
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4 | 10:11:01: File /home/p/examples.c opened(3). 
| Status 10:11:26: New file "untitled" opened. 


5 10:11:41: File /home/pi/struct.c saved. 


Compiler | 10:11:43: File /home/pi/examples.c closed. 
Y | 10:11:43: File /home/pi/input.txt closed. — 
line:23/24 cok4  sekO0 INS TAB mode: Unix (LF) 


encoding: UTF-8 3 filetype: C 


scop 


We use a typedef to create a data type called 
MY_DATA. The definition of the structure consists of 
the keyword struct with a list of variables enclosed 
by curly brackets. In this case the structure consists of 
three integer variables. 

In the main function, we declare an instance of the 
structure as a variable called data of type MY_DATA. 
We then access the individual elements of the 
structure by giving the name of the structure variable 
(data), a full stop (.), and the name of the specific 
element. So the line data.inval1 = 5 sets the value 
of the element inval1 of data to 5, and so on. 

The function add takes a pointer to a MY. DATA 
structure as its only argument. As ever, a function 
cannot change the values of its arguments, but can 
change values pointed to by its arguments, so we pass 
a pointer rather than the structure itself. 

To access the elements of a structure from a pointer 
to it, we replace the full stop with an arrow made up of 
a minus sign and a greater-than sign (-»). So the add 
function reads the values of invali and inval2 in the 
structure pointed to by d, and then writes the result 
back to outval in the same structure. 

Structures are useful if you need to pass a lot 

of data around between functions. They are more 
memory efficient than having large numbers of global 
variables, as you only need to create the structure 
when it is needed rather than taking up memory all 
the time. 


USE 
DIFFERENT 
NAMES 


While it is 
perfectly valid 
to give a local 
variable the 
same name 
as a global 
variable in the 
same program, 
dont do it! If 
you have a 
global and a 
local with the 
same name, 
the local 
version is used 
in the function 
in which it 

is declared, 
and the 
globalis used 
everywhere 
else - this 

can result in 
unexpected 
behaviour. 
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Tutorial 


STEP BY STEP 


LUKE CASTLE 


Luke likes coding and taking old Space 
Invaders games apart. He was in the 
top 50 for Astro Pi and created Pi 
fitness app PiMetre. 
magpi.cc/2iUTZXz 


SCRATCH GAME: 


Create a Scratch game that tests your skills at parking. 
Will you get your Scratch driving licence? 


» Car sprite 
magpi.cc/ 
2kiV2gc 


» Car park 
backdrop 
magpi.cc/ 
2kj3sEB 


> Coin sprite 
magpi.cc/ 
2kj3pbR 
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n this tutorial, we'll make a basic parking 

game using colour-based collision sensing 

with Scratch. Scratch is a child-friendly 
programming environment, developed by MIT. You can 
create games, music or even apps in this platform, and it 
is used in ICT lessons in schools. For this guide, you will 
follow some easy steps to create a simple but effective 
game. We will also be using angles, thanks to Miss 
Skelton, the author’s maths teacher. 


Design 

Download the assets from the list on the left and import 
the car park backdrop. Next, add the coin and car sprites. 
They'll be way too big to start with, so you will need to 
shrink each of them to the desired size by repeatedly 
clicking the ‘four inwards arrows’ icon above the stage. 


Alternatively, you could create your own sprites 
and backdrop to make your game unique. Maybe you 
want to replace the blue river on the backdrop with a 
pink river, or replace the trees with footballs? If so, 
it is easy to edit or paint a new sprite costume using 
Scratch’s built-in editor, so be creative. 


Start! 

Let's make sure the car doesn't start near the coin or 
on the grass - we all want a fair chance of earning our 
driving licence. Instead, it should appear at the start 
line on the left. With the car sprite and its Scripts tab 
selected, you will need to grab a when green flag 
clicked Events block and drag it into the scripts 
area. Then attacha go to Motion block under it and 
replace the number in x with -229 and y to 24, so the 
car starts at the middle of the stage's left edge. In 
addition, we need to ensure the car points to the right 
following any failed or successful attempt, so add a 
point in direction 90 Motion block. 


On your marks... 

Let's get the car on the road. Under the previous 
blocks, attach a wait 5 seconds Control block. 

This will give the player five seconds to get the mouse 
ready at the start of a game. Next, add a forever 
Control block. Inside the latter, place a point towards 
mouse-pointer Motion block, then a move 5 steps 


e This is the main objective of your game: 
get the coin and earn your driving licence, 
otherwise you'd better catch the bus 


|  - This is your car that you steer 


using the mouse pointer. Try 
to stay on the road! 
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Voindd Nore your Computer 


Ovanioed te your computer 


Motion block. This bit of code means the car will 
forever head towards the mouse-pointer. You can 
change the number of steps in the move block to alter 
its speed if you like. 


>STEP-04 

Crash detection 

Next, we’ll create some code to check whether the 

car has hit the grass. Under the previous blocks, still 
within the forever block, addan if then Control 
block. In its small hexagonal field, adda touching 
color Sensing block. Click its blue square, then click 
on the green grass of your course on the stage to set 
the correct colour. In the gap of the if then block, 
place a say Game Over for 2 seconds Looks block, 
then attacha stop all Control block - this will stop 
all scripts running when the car crashes. 


>STEP-05 

Grab the coin 

We now need to create a second script for the car, to 
detect whether it is touching the coin in the parking 
space. Add another when green flag clicked block 
to the scripts area, then attacha forever block. Inside 
the latter, placean if then block. In its hexagonal 
field, adda touching Sensing block, and click its drop- 
down to change it to Sprite 2 (or the name of your coin 
sprite). In the gap of the if then block, placea say 
You Win for 1 seconds block, then attacha stop 
all block. This script makes sure that after the green 
flag is clicked, if the car is touching the coin, the car will 
say ‘You Win’ and the game will stop. 


>STEP-06 

Play it 

You have now created a very basic parking game. 
We’ve made it fairly simple, so you should be able 
to code it and play it within an hour. Have a go on 
the game and see whether you can earn your driving 
licence - or should you just stick with a bus pass? 
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Stopsbystep Howto — Blocks 


Follow thene tutorials to gel started with your 


i 


» 
E ü 
n a 


m ak 


LY & > H 4 5 


when clicked 


go to x -229 FA 24) 
point in direction QJ 


point towards mouse-pointer 
> 

move (B steps 
D^ 


if touching color 7? -then 


say (EEE for © secs 
b 


stop all 


E. 


when clicked 


touching thumbs-up-gold-coin-h! . ? ;then 


stop other scripts in sprite 


k 
say for €) secs 
|: 


Now it's your turn. Here are some challenges for you 
to complete. Can you get the car to restart following a 
crash? How about creating a 5-4-3-2-1 countdown at 
the start of the game? Maybe you could add a timer? Can 
you create multiple levels? Why not add a coin variable? 
Instead of the car saying you have lost or won, why not 
make a special backdrop for the announcement? Why 
not, when you pass, create a driving licence? Otherwise, 
change the game in any way you want. 


Left You'll need 
to code this in 
Scratch 2.0, 

So open up your 
browser and go to 
scratch.mit.edu 


Left This is the only 
piece of code you 
will need to create 
your basic game 
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FREQUENTLY 
ASKED QUESTIONS 


YOUR QUESTIONS ANSWERED 


NEED A 
PROBLEM 
SOLVED? 


Email magpi@raspberrypi.org or 
find us on raspberrypi.org/forums 
to feature in a future issue. 


Your technical hardware and software problems solved... 


RASPBERRY Px 


SPEEDS 


62 


Right How 
quickly do all 
the pieces of a Pi 
communicate? 


Processor 

This is a bit different depending on the Raspberry Pi. 
The Model A, B, A+, and B+ are 700 MHz single-core 
processors. The Pi Zero and Pi Zero W have the same 
processor but it clocks at 1 GHz. The Raspberry Pi 2 
and 3 are both quad-core, with the Pi 2 at 900 MHz 
and the Pi 3 at 1.2 GHz. The Pi 3 processor is also 
64-bit, but it is used in 32-bit mode. 


USB 

The USB ports on all models are USB 2.0, which means 
they are limited to about 280 Mbit/s. On models with 
wired internet (Model B, B+, 2 and 3), the network 
cable is routed through the USB ports. 


Networking 

As the Ethernet is routed through the USB ports, you 
cannot make full use of Gigabit LAN on the Raspberry 
Pi. The networking is limited to 100 Mbit/s maximum 
speed. The wireless networking on the Pi 3 and Pi 
Zero W is 802.11n operating at 2.4 GHz, which means 
it operates at a maximum of 150 Mbit/s. 


Processor 

You can overclock the Raspberry Pi (increase the speed 
of the CPU), although with the Pi Zero, Pi Zero W and Pi 3 
you do so at your own risk. Other models support official 
overclocking modes in the config menu, increasing the 
CPU speed to up to 1 GHz. Any overclocking outside 
these menu options is at your own risk. 


USB 

You cannot increase the USB speed, but using fewer 
USB devices at any one time will help to improve 
performance. Make sure your USB devices are USB 2.0 
Hi-Speed, and that they are properly powered. 


Networking 

You can increase the speed of your wired network 
by using a USB Gigabit LAN adapter. While it won't 
be a full Gigabit, it will be somewhat faster than the 
standard Ethernet connection on the Raspberry Pi. 


GPU 

The VideoCore IV for the Raspberry Pi is rated at 

250 MHz and can do 24 GFLOPS. The Raspberry Pi 3's 
VideoCore has been overclocked slightly so it runs 
between 300 MHz and 400 MHz depending on whether 
it is working on 3D or video. 


CSI 

This is the connector for the Camera Module. It has 

a fairly high data rate of about 1 Gbit/s maximum per 
lane. There are a couple of available lanes in the CSI of 
the Raspberry Pi, so it has a maximum perfomance of 
about 2 Gbit/s, although the camera only uses one lane. 


DSI 

The DSI is used to connect a screen to the Raspberry 

Pi. It runs at about the same speed as the CSI. Both are 
connected directly to the GPU, so they can't be used for 
generic data in the same way as a USB port. The DSI only 
uses one of its lanes when displaying data on a screen. 
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YOUR QUESTIONS ANSWERED 


FROM THE RASPBERRY PI FAQ 


RASPBERRYPI.ORG/HELP 


Why is there no real-time clock (RTC)? 


The expectation is that non-network-connected units 
will have their clocks updated manually at startup. 
Adding an RTC is surprisingly expensive once you have 
factored in batteries, area, and components, and would 
have pushed us above our target price. You can add one 
yourself using the GPIO pins if you'd like an interesting 
electronics project. 


Can I add extra memory? 


No. The RAM on the Model A, A+, B, B+, Zero, and Zero W is 
a package-on-package (PoP) on top of the SoC, so it is not 
removable or swappable. The 1 GB of RAM on the Model 2 
and 3 is on a separate chip on the bottom of the PCB, but 
this is the maximum amount of RAM that the SoC in the 


Why doesn't the Raspberry Pi include «insert name» 
piece of hardware or «insert name» sort of port? 


Our main aim is a charitable one: we are trying to build 
the cheapest possible computer that provides a certain 
basic level of functionality, and keeping the price Low 
means we've had to make hard decisions about what 
hardware and interfaces to include. 


What is its operating temperature? 


The Raspberry Pi is built from commercial chips which are 
qualified to different temperature ranges. The LAN9512 

is specified by the manufacturers as being qualified from 
0°C to 70°C, while the AP is qualified from -40°C to 85°C. 
You may well find that the board will work outside those 
temperatures, but we're not qualifying the entire board to 


more recent models can support. these extremes. 


KEEP MULTIPLE 
PROJECTS IN 
ONE PLACE 


WD PIDRIVE FOUNDATION EDITION 
MADE FOR RASPBERRY PI 


Our custom NOOBS software enables you to install 
Project Spaces, so that you can create up to 5 projects 
that can all be managed from the WD PiDrive. 


CHOOSE THE USB FLASH 64GB USB HARD DRIVE 
VERSION THAT'S Includes MicroSD" Card 250GB / 375GB 
RIGHT POR UOUS $18.99 Includes MicroSD" Card with starter 


software and WD PiDrive Cable 
Starts at $28.99 


Learn more at wdlabs.io/mp57c 


© WDLABS 


Western Digital, WD, the WD logo, WDLabs, and the WDLabs logo are registered trademarks or trademarks of Western Digital Corporation or its affiliates in the U.S. and/or other countries. Raspberry Pi is a trademark of the Raspberry Pi Foundation, microSD is a trademark of SD-3C, 
LLC. The term HDMI is a trademark or registered trademark of HDMI Licensing LLC in the United States and other countries. All other marks are the property of their respective owners. As used for storage capacity, one gigabyte = one billion bytes. Total accessible capacity varies 
depending on operating environment. Product specifications subject to change without notice. Pictures shown may vary from actual product. © 2017 Western Digital Corporation or its affiliates. 


Everything you need to build awesome projects 


W) e’re into digital making here at The MagPi. the big impressive builds. If you have collected a few bits and & 


Incredible projects using Raspberry Pis cross bobs to build these small projects, you may have assembled 
our news and social feeds every day, and we the kit you need to attempt something bigger. 


love to discuss them and how we’d go about making Over the next few pages we'll show you what you 
them. We tend to cover many programming and small need to make your own amazing, Raspberry Pi-powered 
projects in the magazine, so we don’t often get to do monster projects. 


feature 


PROTOTYPING 


Taking your first steps into building circuits for a project 
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he humble breadboard 

is an amazing device for 

prototyping circuits. We often 
use them in our tutorials, as they 
allow you to quickly wire up LEDs and 
other components to test concepts 
for your projects. Hopefully you 
already have one, but if not you can 
buy them from anywhere that sells 
electronics components, including 
Pimoroni, The Pi Hut, ModMyPi, etc. 

Breadboards allow you to connect 

up components without the need 
for soldering. You can reuse the 
components and quickly rearrange 
them to test your ideas. You can 
wire them up to each other and to a 
Raspberry Pi to create a circuit. Some 
of the holes are connected by built-in 
strips of metal, allowing you to use 
fewer wires to complete your circuit. 


A diagram showing how the holes in 
a breadboard are connected. Keep these 
connections in mind as you build 


A common input device; pushing 
down the button completes the 
circuit. Inputs can also include light 
sensors, temperature sensors, etc. 


You can use these components in a 
breadboard. Most of them can be used 
in your final circuits as well. 


This wire uses a single core of 
metal throughout, which means 
that it bends easily. This makes it 
easy to use for prototyping circuits. 
While you can solder with this wire, 
it is not ideal for soldered circuits. 


These make it very easy to hook up 
a breadboard to the Pi. 


Most electronic circuits will require a 
resistor. Different circuits will require 
resistors of different strengths. 


The classic LED can be 
used to test your circuit, 
or to add lights to your 
project. Other outputs 
include buzzers, 
speakers, motors, 
actuators, and more. 


May 2017 MägPi | 65 


BUILDING 


REAL CIRCUITS 


Turn your prototype circuit into a permanent circuit 


readboard circuits are 

great, and you could easily 

fit one into a project if you 
have space. Alternatively, use a 
soldering iron to make your circuit 
smaller and more permanent, and 
to protect against loose wires. 
Here's what you'll need to get 
started with soldering. 


HELPING HANDS 
When soldering tricky circuits, you 
can sometimes feel as if you need 
SOLDERING IRON several sets of hands. 'Helping 
The most important piece of kit for hands' can help! They usually 
soldering is the device that allows include a heavy base and two 
you to solder. It's basically a very crocodile clips, so you can hold two 


hot pen tip that melts a metal alloy. things together steadily. They often 
After cooling, the solder keeps your include a magnifying glass to help 
wires and components in place, and with very delicate tasks. 

conducts electricity. 


DESOLDER PUMP 


SOLDER If you need to remove some solder 
This is the metal alloy that melts and from a circuit, heat it up with the 
cools to join components and wires soldering iron and then suck it up 
together. It usually contains tin and with this handy tool before it cools. 
lead, or tin and copper. Also known as a 'solder sucker. 
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MULTICORE WIRE 

This bendy, flexible wire is much 
better suited to soldering than the 
single-core wire used for prototyping. 


WIRE CUTTER/STRIPPER 


A special tool that not only helps you 
to cut a wire to the desired length, 

but also can strip the plastic coating 
away from the metal inside. 


CHOOSING A 
SOLDERING IRON 
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Measure twice -— - 


Make sure your wire is the 
correct length for your circuit. 
You can always strip one end 
and leave the rest attached to 
the spool to cut later. As the 
wire is very flexible, it is best 
to cut ita little longer than 
you need it to be. 


Tin the wire 

Once you've stripped the plastic, 
you should tin the wire. Hold 
one end in a ‘helping hand’ and 
apply some solder to the exposed 
wire so that it coats and covers 
it. This makes it easier to solder 
onto something else. 


Attach the wire 

Helping hands come in very 
handy here, holding both 

the wire and the component 
you want to solder. It is 

good practice to tin the leg 

of the component and the wire 
you want to solder to it, and 
then heat up the solder on both 
in order to fuse them together. 


Physical circuits can be finished off by tying up trailing wires 
and using wire wrap to cover exposed connections. Wire 
wrap shrinks as it is heated up (with a heat gun or hair dryer) 
and keeps your connections safe and secure. To protect a PCB 
solder joint, we recommend covering it in a little hot glue 
using the low temperature setting on a glue gun. 
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TOOLS FOR 


You’ll find different 

screw measurements 

used online, depending 1-64 
on whether the guide ^ 3-48 
you’re following uses ^ 4-40 


imperial or metric 6-32 
scales. Here'sahandy 8-32 
table for converting 10-24 
screw diameters 1-20 
between imperial (UNC 54-18 
or UNF) and metric. 35-16 
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1-72 
3-56 
4-48 
6-40 
8-36 
10-32 
1-28 
5,6724 
35-24 


M2 x 0.4 
M2.5 x 0.45 
M3 x 0.5 
M3.5 x 0.6 
M4 x 0.7 
M5 x 0.8 
M6 x1 
M8 x 1.25 
M10 x 1.5 
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MAKERS’ TOOLKIT 


~ PRINTING 


A new way to make cases and parts, 3D printing can make makers’ dreams a reality 


SORTING OUT YOUR FILES PRINTING YOUR FILES 


Think of a 3D printer as being like 
a 2D printer: for 3D printing, you 
need to prepare the files you want 
to print. If you're printing files 
that someone else has designed, 
the process should be very easy. 
Download and sort through the 
files recommended for your 
project, and make sure you are 
using the right ones. 3D- printable 
files will usually have file names 
ending in .stl or .vrml. 


The more simple the design, 
the easier it will be to print 


Making your own files 
involves diving into the world 
of 3D modelling software. You 
can choose from many paid 
professional programs, but there's 
also the free and open source 
Blender 3D modelling software. 
There is a helpful guide to using 
Blender here: magpi.cc/20xxWFA. 
Remember, standard 3D printers 
print from the ground up in slices 
or layers. Keep this in mind when 
designing pieces to be assembled 
after printing. 


Once you have your files, you need to print them. 
You could get yourself a 3D printer (we’ve always 
liked the MakerBot series), which then allows you 
to print as much as you want (plastic permitting), 
making tweaks to allow for the perfect print. 
Printers are very expensive, not to mention noisy, 
so a popular alternative is to find a local 3D printer 
on 3DHubs.com, and send the files to them. They'll 
be able to give you recommendations on materials to 
print with, and they will usually mail the items back 
to you, or allow you to pick up the print yourself in 
some cases. There's plenty of choice, and they are 
alot cheaper than 
the setup cost for 


a 3D printer. 

Of course, if you 
plan to do alot of 
3D printing, you 
might be better off 
paying the extra and 
investing in a 3D 
printer of your own. 


Printing on 3D Hubs can 
bea lot cheaper than 
you think 


p ————————Á———————————— — M: 


FINISHING YOUR PRINT 


Typically, 3D printed objects have 
a rough surface texture, due to the 
layering nature of the printing 
process. You can change the way 
you print to cut down on this 


^ An amazing 
idea for a 3D print 
project we covered 
in issue 56. 


surface finish. These take very 
little work, but they have their own 
disadvantages: you’ll need to build 
your own DIY kit and deal with 
some nasty chemicals. 


=> ow Before and 
after images of an 


acetone vapour- 
effect, either by using different Don’t forget to buy a small round smoothed 3D print 
3 " 4 à : from PeterA8's 
materials or by employing a file to widen screw holes if you great guide: 


different 3D printing technique. need to! 

Mostly, you'll find yourself 
sanding and filling and sanding 
and filling again to produce a 
smooth finish. Another solution 
is to add layers of PVA glue, which 
can be easily painted over. 

You can also try using acetone 
vapour baths to smooth out your 


magpi.cc/2oxLj8R 
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WOODWORKING 


Take your first steps into carpentry and make some truly wonderful projects 


— — 
fully stocked woodworking POWER DRIL agi 
workshop can be vast, Need to make some holes? This is owe m 
includes a lot more than what you need. Pick up a variety of $ — 

just a saw, and can get quite drill heads for wood and you'll be on 

expensive. Along with the tools your way. Be careful, though, as drills 

in your makers’ toolbox, here are can be dangerous. Wik 

some of the basics you'll need for 

projects involving woodworking. VICE f ] 


Keeping your wood in place with a 
vice makes it easier to cut. We also 
really like the workbenches that 
grip your piece of wood, and even 
create a gap underneath so you can 
safely drill holes without damaging 
the bench. 


TAPE MEASURE AND PENCIL 
It seems obvious but it's worth 
repeating. You don't want to go 
about measuring with the 15 cm 
ruler from your old school pencil 

kit. Remember the golden rule: 
measure twice, cut once. 


CLAMP 

Clamps are very useful for holding 
sections of wood in place, to drill 
uniform holes or make precise cuts. 
You'll need several clamps for the 
best results. 


POWER TOOLS 


Want to improve your carpentry skills? Then you may want to get some 
power tools. Of course, these should only be used with adult supervision. 
We recommend a power sander (sanding large bits of wood by hand is very 
boring) and a jigsaw. 

A jigsaw is a handheld tool with a saw blade jutting downwards. It is very 
useful for cutting complex shapes into, or out of, a piece of wood. To use it, 
you rest the metal plate on the wood and push the jigsaw along. This pushes 
the blade through the wood, usually following a pre- marked path. 


ETETE ems 
FIRST! = 
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feature 


The 

Makespace in 
Cambridge is one of 
our favourite places 
in the world (and 
it's usually a bit 
quieter than this) 
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MAKERSPACES 


No space for a workshop? Find a local makerspace 


akerspaces (also known as 
M hackerspaces) are amazing 

places where people come 
together to build things. From 
software to circuits and 3D prints 
to metalwork, a good makerspace 
gives you access to loads of tools for 
building and making. Buying tools 
can be expensive and finding space 


can be difficult. Many makerspaces 
require only a small monthly 
membership fee to use all their 
equipment. They're also usually 
filled with knowledgeable people 
who can help you with any tricky 
parts of your projects. 

To find a makerspace, check out 
hackspace.org.uk and look for 


locations near you. Alternatively, 
a bit of Google-fu should help you 
find somewhere in your area. 

Being a maker is also about 
being part of a wider community, 
and joining a makerspace can 
open the door to a community of 
makers, and a wealth of support, 
on your doorstep. 
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£12.99 


200 pages of 


RASPBERRY PI 


PROJECTS BOOK 


VOLUME 2 


Amazing hacking and making projects 
from the creators of MagPi magazine 
Inside: 

How to get started with Raspberry Pi 
The most inspirational community projects 
Essential tutorials, guides, and ideas 


Expert reviews and buying advice 


Available 
mE magpi.cc/MagPiStore 


plus all good newsagents and: 


WHSmith BARNES&NOBLE 


4 Available on the GET IT ON Available on 
€ AppStore lll P> Google Play a Amazon 
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Maker 
says 
Build 

your very 


own internet- 


connected 
radio with 
the Pirate 
Radio Kit! 


Pimoroni 


PIRATE RADIO 


PIRATE RADIO 


PI ZERO W PROJ 


This musical pirate booty is something to treasure 


AMP ZERO 
PHAT 


JustBoom's 
Zero-sized 
board delivers 
up to 20W 
RMS of high- 
resolution 
audio to a pair 
of passive 
speakers using 
an optional 
external 
power supply. 


£24 / $37 
magpi.cc/2INJMKO 
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he most expensive of 
the four new Raspberry 
Pi Zero W project kits 
from Pimoroni, the Pirate Radio 
comprises a case full of quality 
components - everything you 
need to build your own internet 
radio. As with the other three 
kits, the packaging is top-notch 
and the hinged plastic case 
can be reused to store other 
components after the build. 
The key electronic items 
featured in the Pirate Radio kit are 
a Pi Zero W, with built-in wireless 
` LAN and Bluetooth, and one of 
] Pimoroni’s new pHAT BEATs. Also 
* available separately, the latter is a 
~ neat bit of kit that crams dual I2S 
DAC/amplifiers onto a Pi Zero- 
sized board, and can pump out 
3W per channel. 


The body of the radio is fairly 
easy to assemble - from acrylic 
pieces, legs, retainers, nuts and 
bolts - using the illustrated 
step-by-step online guide 
(magpi.cc/201i7d7). As long as you 
follow the guide carefully to get 
the orientation right, everything 
slots together neatly. The acrylic 
pieces are all laser cut, including a 
neat speaker grille, so there are no 
nasty rough edges. 

The supplied 5W speaker simply 
slots onto four bolts holding the 
translucent front acrylic layer in 
place. Fortunately, the speaker 
comes with a length of dual wire 
already connected, so there's 
no need to solder it. We're not 
sure why the wire is much longer 
than required, though; while you 
could always cut it to size, we just 


ECI KIT 


wound it round the bolts at the rear 
of the radio. 

Unless you opt to buy a couple 
of Pimoroni's ingenious hammer 
headers separately, you will need 
to break out the soldering iron 
to attach the supplied standard 
male and female headers to the Pi 
Zero W and pHAT BEAT. The latter 
then slots onto more bolts at the 
rear of the radio, with the Zero W 
mounted on top. The speaker 
wires are inserted into a couple of 
the terminal blocks on the pHAT 
BEAT, with the latter's dip switch 
set to mono to combine its stereo 
channels. With that, your internet 
radio is built! 


Streaming software 
The Pi Zero W's built-in wireless 
connectivity means there's 
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no need to use a WiFi dongle 
plugged into a USB to micro- 
USB adapter, which makes for 

a more streamlined look to the 
radio. Even so, such an adapter is 
included in the kit, along with an 
HDMI adapter. This is presumably 
to enable you to hook the Zero 

W up to the monitor to install 
the software in Raspbian and set 
up WiFi, although we went the 


Quality components — 
everything you need to build 
your own internet radio 


instant headless route by adding 
ssh and wpa_supplicant.conf 
(with our router details) files to 


can be controlled via the pHAT 


BEAT’s five side-mounted buttons: 


forward/back to select stations, 
pause/play audio, and volume up/ 
down. The only slight downside 

is that the buttons are tiny, anda 
little difficult to locate on the side 
of the radio at times. The sound 
quality is good, however, with 

a decent amount of volume. Its 
real-time volume level is shown 


dynamically by the pHAT BEAT’s 
super-bright LED VU meter. 
In addition, we followed 


PIRATE RADIO 


PIMORONI 


Left The kit 


in this neat 


pHAT BEAT 


Pimoroni's new Pi Zero-sized audio board packs 
twin MAX98357A DAC/amplifiers for stereo output. 
While the Pirate Radio uses mono mode, you could 
always add an extra speaker. Alternatively, you 

can buy the pHAT BEAT separately (£16.50/$21) 
and build your own custom stereo radio, or even 
repurpose an old ghetto blaster. The pHAT BEAT 
also features six push-buttons and two rows of 
super-bright APA102 RGB LEDs, for use as a VU 
meter or custom-controlled using the board's 
Python library (magpi.cc/20tOwp6). 


reusable case 


comes packed 


Pimoroni's tutorial to turn the 
Pirate Radio into an AirPlay speaker 
for streaming audio from an iPhone 
and iPad. Both this and the VLC 
radio work alongside each other 
happily, so you can switch from 
one use to the other. Highlighting 
the radio's versatility, Pimoroni 
has also put together a Spotify 
streaming project using Modipy, 
controllable from a remote 
computer or device. 


the microSD card before first boot. 
On the software side, Pimoroni 
has put together guides for three 
project examples. The first is for 
an internet radio based on the 
VLC daemon. As with the other 
examples, a single command is 
used to install all the required 
packages. You can then edit the 
playlist file to add URLs for your 
favourite radio stations. With 
this particular project, everything 


While it's a slight shame that it doesn't make use 
of the pHAT BEAT's stereo capabilities, this is an 
excellent kit that is easy to assemble and results 
in a genuinely useful audio device with good 
sound quality. As well as internet radio and music 
streaming, potential uses include an Alexa-style 
voice assistant (with the addition of a USB mic), 

a speaker for musical HATs, and a speaking clock. 


raspberrypi.org/magpi May 2017 MägPi | 75 


Maker 


says 
A 


powerful, 
Sleek and 
intelligent 
smart device 


t 


hat is 


perfect for 


C 


ontrolling 


your high- 
definition 
audio setup 


J 


ustBoom 


RII MINI I7 


Asimilar idea to 
the JustBoom 


remote, this 
one has a few 
more features 


to allow use as 


a wireless PC 
mouse as well. 


£15 / $33 
magpi.cc/2mLP3qc 
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JUSTBOOM SMART REMOTE 


JUSTBOOM. 
SMART REMOTE 


A minimalist AV remote with a six-axis gyro installed. 
Should this replace your current media remote? 


here were always jokes 
about the Wii Remote 
looking like a TV remote 
control, and it looks as if the 
JustBoom team has taken these 
jokes as inspiration for a slightly 
different kind of media remote. 
While looking simplistic, with only 
a few buttons, the Smart Remote’s 
secret is that it contains a six-axis 
gyroscope that allows for a degree 
of motion control. 
Luckily, this feature isn’t 
on all the time. It is activated 
and deactivated by pressing 
the button in the middle of 
the volume control strip, and 
emulates a mouse pointer moving 
around the screen as the user 
dictates, by flicking and tilting 
the remote. 
It works pretty well, making an 
instant transition between modes, 


and can easily be recentred by 
turning the motion controls off 
and on again. We found on Kodi 
that it tracked across the screen 
fairly slowly, forcing you to bend 
your wrist to extreme angles to get 
to the corners. On Windows PCs, 
and indeed on the Raspberry Pi, it 
required less work to move around 
the screen. 

As for being a pure media 
remote, it does the job well. 
JustBoom claims that it’s designed 
to have the bare minimum of 
useful buttons for media viewing, 
and for Kodi this works well. 

The thing we missed most was a 
Play/Pause button, but you can 
definitely get used to tapping 
OK twice to pause, so it’s quite 
a minor complaint. 

The build quality is pretty 
decent as well, with the buttons 


making satisfying clicks as you 
push them. They’re also nice and 
large, so you’re unlikely to push 
the wrong one. 

As mentioned earlier, they do 
work on the Raspberry Pi desktop, 
which is pretty neat. The OK button 
works as a normal mouse click, 
and Back and Home work ona 
browser. It could well be useful in a 
classroom environment, as well as 
in the home, for media viewing. 


{ast word 


It's a decent bit of kit 
with a unique feature. 
We'd like a Play/Pause 


button, but otherwise it's 
perfectly serviceable. 
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PAPIRUS ZERO MEDIUM 


Review 


PAPIRU 


ZERO MEDIUM 


An ePaper screen for the Raspberry Pi Zero 


PAPIRUS 
HAT 


The original 
full-size PaPiRus 
features a taller 
display, up to 
2.77 inches 

in size. The 
same ePaper 
technology is 
used to render 
text and images. 


d 


£35 / $50 


magpi.cc/2ouxPtz 
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any moons ago, we took a 

look at the original, full- 

size PaPiRus HAT. Now 
it's the turn of its smaller sibling, 
designed specifically for use with 
the Pi Zero. Unlike conventional 
displays, it uses electronic paper 
(ePaper) technology to render text 
and images, which can remain 
on screen without any power 
connection for many days before 
slowly fading. Obviously, this is 
ideal for saving battery power in a 
portable project, such as a smart 
conference badge. The display is 
high contrast and readable even in 
bright sunlight. 

Like its big brother, the PaPiRus 
Zero is supplied in two main 
parts: the pHAT board with pre- 
soldered female header, and the 


- screen itself, which is very thin. 


Assembly involves inserting the 
screen's mini ribbon cable into 
the connector at the side of the 
pHAT, then securing the screen to 


the board with the double-sided 
sticky pads supplied. We tested 
out the 2.0-inch Medium display 
with 200 x 96 pixels, but a Small 
1.44-inch screen (128 x 96) is also 
available, along with a multi- 
screen pack containing both sizes. 
With the unit assembled and 
mounted on a Pi Zero’s GPIO 
equipped with male header (not 
supplied), it's time to install the 
software via a single Terminal 
command. A second command is 
required to set the correct screen 
size, then you're ready to roll. 
One of the installed folders 
contains a few Python code 
examples to get you started, 
including a temperature readout 
that makes use of the pHAT's built- 
in LM75 temperature sensor. The 
Buttons example demonstrates 
the use of the pHAT's five GPIO- 
connected buttons. Located along 
the top edge, they're tiny but could 
prove useful for switching the info 


Maker 
says 
Add low- 

power display 

technology to 
your Pi Zero 


projects! 
Pi Supply 


displayed. Other code examples 
include Conway’s game of life, 
which works well, and a digital 
clock. While some minor latency is 
noticeable as the numbers change 
on the latter, a ‘clear’ command can 
be used to wipe the display clean. 
The Papirus Python library 
includes a write function to 
print text strings, which can be 
positioned and sized, although it’s 
not clear how to change the font. 
A draw function displays a one-bit 
(black and white) bitmap image - 
The MagPi logo looked really cool! 
Handily, the software will convert 
most image types automatically. 


{ast word 


While not suitable for 
applications requiring a fast 
screen refresh, the PaPiRus 
Zero is ideal for saving battery 
power in portable projects. The 


ePaper display is very easy to 
read in all but the Lowest light 
conditions, from any viewing 
angle, and features a decent 
110 ppi pixel density. 
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GROUP 


IDEs: 


Which program should you be using to code on the Raspberry Pi? 


GEANY 


A very popular cross-platform IDE, Geany has been around for 
quite a while and has received a reputation as a nice lightweight 
alternative to the bigger IDEs like Eclipse. It's perfectly suited 
for the Raspberry Pi, aiding you in coding in all manner of 
programming languages, and it’s actually pre-installed on 
Raspbian PIXEL by default. 

As well as allowing for the all-important highlighting of code 
depending on the language, Geany also offers the ability to test 


he humble integrated development 
environment (IDE). Used the world over 
to play with code and make programs on 


computers of all kinds. You're probably familiar with 
Scratch or IDLE, IDEs that serve a specific purpose, 

in this case coding in Scratch or Python respectively. 
Some IDEs let you program in several languages. Here 
are some of the best on the Raspberry Pi. 


CODE:BLOCKS 


A fairly traditional IDE, Code::Blocks is well 
known as an alternative for C coding, but it 
can handle many different languages as well. 
It's not included in Raspbian PIXEL by default 
but it is in the package manager, so it's just 

a case of installing it from the Terminal or in 
the software installer. 

Code::Blocks lets you organise your code and 
projects very easily, displaying the different 
functions and classes and whatever is important 
in the sidebar. It also contains a lot more 
debugging, testing, and building options than 
main rival Geany; however, we had some issues 
getting it to preview some Python code. 

It's a very solid choice if you need a little more 
data and debugging in your projects, and again 
you can run compiled software straight on your 
Raspberry Pi for very efficient testing. 


codeblocks.org 
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code in a very similar way to the Run function in IDLE. Different 
variables and functions can be jumped to from the left-hand 
column, allowing for quick browsing of the entire code. 

It's a great piece of software that allows you to easily manage 
files and entire projects that use many types of code, and as it's 
already on Raspbian, you can test your code on it as well. 
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ADAFRUIT 


A quite different IDE, this one resides 
completely online. It’s not like Scratch 2, 
though, where you work on software online. 
This is a hybrid system that you install on the 
Raspberry Pi and then access via a web browser 
on a networked computer. 

The code and software on here is then stored 
in the cloud through Bitbucket, meaning you 
can access it from anywhere. Code can also be 
run directly to the Raspberry Pi via a Terminal 
so you can test it out as well. It allows you to 
use a whole host of different programming 
languages, and supports decent highlighting 
of them all. 

It doesn’t offer the same debugging and 
compiling suites of Geany or Code::Blocks, 
nor does it have a breakdown of functions and 
variables, instead favouring a project overview 
with your folders and files visible at all times. 
Still, it’s a great idea, especially when using a 


e QUE 9 C Anni n $ F 4a [eaten 


. "M headless Raspberry Pi. 


Running locally on the Raspberry Pi, gedit is the GNOME text 
editor. While there is already a text editor in Raspbian, gedit 
supports code highlighting for a variety of programming 
languages, which the default text editor does not do. 

You'll need to install it from the package manager, and it does 
add a fair few other packages to get it running. The good thing is 
that as well as being in the program menus, you can access it via 
the Terminal if you want to edit a file in there. Instead of using 
something like nano python.py you can use gedit python.py. 

It's quite simple, though, offering just a pure view of the 


code with some highlighting and no project view, debugging, or DISTRACTION-FREE 
compiling options. It's pretty good if you need just a simple IDE CODING AWARD 


that has few distractions. 
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RASPBERRY PI 
BESTSELLERS 


The new computing curriculum is a big 
step for many teachers. These useful 
guides will ease the transition. 


DEPLOYING RASPBERRY PI 
IN THE CLASSROOM 


Author: Guy Hart-Davis 
Publisher: Apress 
Price: £19.99 

ISBN: 978-1484223031 
magpi.cc/2ndLCo8 


A manual of everything 

a teacher, classroom assistant 
or schooLIT admin needs to 
deploy and run a network 

of Raspberry Pis in the 
classroom. Liberate your 
school from Excel boredom! 


PYTHON IN EDUCATION 
TEACH, LEARN, PROGRAM 


Author: Nicholas Tollervey 
Publisher: O'Reilly 

Price: Free download 
ISBN: N/A 
magpi.cc/2ndCi3U 


Thoughtful introduction 

to Python's strngths and 
suitability for education, 

its readability, simplicity, 
cross-platform, and the 
secret weapon - a wonderful 
community. Pass it on to 

a teacher you know. 


HELLO WORLD 


Authors: Various, contributing 
editor Miles Berry 
Publisher: Raspberry Pi 
Foundation 
Price: Free PDF download 
ISBN: N/A 
helloworld.cc 


Written "by educators, for 
educators," a magazine from 
the Raspberry Pi Foundation 
that takes a cross-curricular 
look at tech, and educating 
young digital makers. A 
fascinating and diverse range 
of useful content. 
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THE HARDWARE 


HACKER 


Author: Andrew Huang 
Publisher: No Starch 
Price: £23.99 

ISBN: 978-1593277581 
magpi.cc/2ndLt44 


Rhee eerie 


The Hard 2 
HACKER 


Part technology 


tour, part cultural 


travelogue, wholly 


engaging - the first section of 
the book takes the reader into the 
electronics markets of Shenzhen, 
and the inside secrets of the 
factories where most makers who 
scale up to full manufacturing 
will end up looking for serious 
production runs. Memorable 
statistics like “Foxconn workers 
consume 3,000 pigs a day,” rub 
shoulders with fascinating asides 
on everything from the use of 
chopsticks in assembling Tux USB 
S 

8 


ticks, to the hidden problems of 
oss-finish plastics. 


UNIX: 


THE TEXTBOOK 


Authors: Syed Mansoor Sarwar, 
Robert M Koretsky 

Publisher: CRC 

Price: £89.00 

ISBN: 978-1482233582 

magpi.cc/2ndNhtU 


Raspbian is one of many 
GNU/Linux distributions 
that can run on the Pi, 
but GNU/Linux itself is one of 
more than 200 members of the 
UNIX family. An operating system 
fast approaching its half century, 
thanks to a number of sensible 
design decisions which, amongst 
other things, have permitted 
gradual evolution, while retaining 
a set of commands which would 
work on a release of any vintage. 
Changes can be most clearly 
seen when a classic old manual 
like this is updated after more than 


The Textbook 


As if that were not enough, a short 
section on ‘intellectual property’ - a 
weasel term that Huang dismisses 

rapidly, before looking at shanzai 

innovations rarely seen here - 
leads on to Huang's investigations 
into fake SD cards. Part 3 starts with 
a brief, personal history of open 
hardware leading on to three open 
hardware platforms built by the 
author: chumby, the Novena laptop, 
and chibitronics. Each a fascinating 
technical and manufacturing story. 

Rounding off this absorbing 
personal guide to the world 
of hardware is a ‘hacker’s 
perspective’ section, with insights 
into reverse engineering, then 
bioinformatics - and some 
surprising comparisons between 
H1N1 and a computer virus. Lastly, 
extracts from interviews giving 
further insights into a remarkable 
career. Essential reading. 


Score 


a decade. Sarwar and Koretsky 
focus on Solaris and PC BSD, but 
the coverage here will be more than 
90% relevant to your Pi, or the VPS 
that hosts your website. The telltale 
changes include a new, 
nearly 100-page chapter 
on Python, and coverage 
of Git and virtualisation. 
You'll need a lot of 
shelf space for this 1300- 
page hardback, but it'll 
pay you back its price 
over many years if you're 
looking for a text book 
which combines introductory 
tutorials on everything from shell 
scripts and systems programming, 
to file encryption and remote 
logins. While not the only good, 
comprehensive ‘Linux reference’, 
its wider remit, and many exercises 
for the reader, make it one of the 
more educational. 


Score 
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PENGO 


AT A GLANCE 


Author: Andrew Shitov 
Publisher: Deep Text 
Price: £26.00 

ISBN: 978-9082156836 
magpi.cc/2ndJnkS 


p 


As the dust settles 
on the long-awaited 
Perl 6, 2017 should 
see the publication 
of several - no doubt weighty - 
tomes on the language. First off 
the mark, with a nicely concise 
introduction (150 pages), Andrew 
Shitov's guide is based on a series 
of introductory articles originally 
written in Russian. 
Perl 6 is not an incremental 
set of improvements over 
Perl 5. It’s a different language, 
beautifully declarative, with useful 
improvements including: good 
concurrency support; a better, 
Smalltalk-influenced object model, 


THE PHOTOGRAPHER'S 
GUIDE TO DRONES 


Author: Colin Smith ; Wet T 


Publisher: Rocky Nook 
Price: £26.99 

ISBN: 978-1681981147 
magpi.cc/2ndyFeh 


Lots of makers 
have bought 
or built drones - they're 
cool and have plenty of potential 
applications - but most people 
aren't planning to set up delivery 
businesses with them. Photography 
from places you can't otherwise get 
tois a great example of technology 
assisting and enabling new creative 
endeavours. Indeed, the first 
few sumptuous pictures in Colin 
Smith's book are of coastal scenery 
and cities taken from several 
hundred yards out at sea, as are 
many of the spreads which open 
each chapter. 

Despite this and the landscape 
format of the publication, it is 
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Perk6 


ata Glance 


lazy evaluation; Lisp-like macros; 
and gradual typing - giving you 
the ability, effectively, to ‘turn on’ 
static typing when needed. Floating 
point numbers can be stored 
as ratios for accuracy, and 
the ‘approximately equal 
to’ operator deals with 
minor imprecisions with e.g. 
complex numbers. 
Perl 6 At a Glance lives up 
to its title, giving excellent 
language coverage with 
no padding or fluff. Short 
paragraphs and code snippets 
take you through everything from 
building a web server, to creating 
new operators. Promises, and Perl 
6’s Channel class, fit the language 
for the concurrent world, and 
Grammars build on Perl 5’s powerful 
way with regular expressions. This 
book will open your eyes to Perl 6’s 
capabilities and uses: it is as concise 
and expressive as the language. 


Score 


more than a coffee table book. It 
is also a practical guide for any 
photographer wanting to take to 
the air without actually 
flying themselves. 
After suitable safety 
warnings - “spinning 
propellers and falling 
objects have the ability to 
injure people,” and most 
countries have regulations 
that you need to be aware 
of (this book is written from a US 
point of view) - it's time to look at 
the gear, from the best available 
drones, to camera accessories. 
Smith has plenty of sound advice 
on flying a drone, and using it for 
photography and shooting video. 
Workflow, post-production, 
advanced techniques (panoramic 
images, special effects), and editing 
video round off an interesting and 
helpful guide. 


Score 


BOOKS 


ESSENTIAL READING: 
MUSIC & AUDIO 


We love Sonic Pi (read our Essentials guide), 
but look what you can also do musically... 


Mastering MuseScore 


Author: Marc Sabatella z 
Publisher: MuseScore 
Price: £25.99 

ISBN: 978-1508621683 
magpi.cc/2ndHZid 


Make and play back beautiful scores, 

and join a community of users sharing MEM 
their music. Superb tutorial and 

comprehensive reference. 


Making Music with Computers 


Authors: Bill Manaris, Andrew R Brown P i 
Publisher: CRC Press f A 


Making Music 


wits Computers i 


Price: £33.99 
ISBN: 978-1439867914 
magpi.cc/2ndCBvf 


Well-written, beginner-friendly guide 
to creating music programmatically - 
with algorithms and data - in Python 
(via Jython). 


z . 


Linux Sound Programming 


Author: Jan Newmarch 
Publisher: Apress 
Price: £27.99 

ISBN: 978-1484224953 
magpi.cc/2ndOOAr 


The missing manual on programming 
all things audio on Linux, from sound 
fonts to controlling latency. 


Music Data Analysis 


Authors: Claus Weihs, Dietmar Jannach, 
Igor Vatolkin, Gunter Rudolph 

Publisher: CRC 

Price: £44.99 

ISBN: 9781498719568 

magpi.cc/2ndoSF6 


MUSIC DATA 
ANALYSIS 


Nicely varied collection of academic 
essays, from instrument recognition 
through machine learning to 
automated composition. 


The TAB Guide to 
Vacuum Tube Audio 


Author: Jerry C Whitaker 

Publisher: McGraw-Hill Education TAB 
Price: £34.99 

ISBN: 978-0071753210 
magpi.cc/2ndAaZF 


Get the most from your DAC HAT with Petco s 
a home-built valve (tube) amplifier. iat 
Fascinating and idiosyncratic reworking 

of classic circuits. 
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FEATURE 


THE MONTH IN 


Everything else that happened this month in the world of Raspberry Pi 


or better or worse, every year on 1 April people 
and companies come together to lie to — sorry, 
fool - their audience in the great tradition of BERE DU IOTER eet) ELE: 
April Fools! Day. The Raspberry Pi community is not 
one to pass up on such an opportunity and there were a VOLTLOG 
few jokes going around on the day, centred around the We're very, very impressed with the working PCB 
humble Blueberry Delta. mock-up of an imaginary Raspberry Pi 4 design 
that was made for this video. It looks very real and 
even lights up! A lot of work went into making this 
Mn E -— | RETROPIE FORUM board just for a little joke. There's a follow-up video 
showing how he made it, which is fascinating. 


G gl The RetroPie forum brought back a -— — 
a bit of a classic joke, redirecting = l3 P A L 
rero documentation everyone trying to get to the Cl = P = [ F g l 


RetroPie forum for support to a 


LMGTFY (let me Google that for F i r 5 [ L @ (m) la 


Google earch I'm Feeling Lucky 


you) page, searching for ‘retropie 
documentation’. ; 9 è 


KODI SHUTDOWN 


In a stealth move to upgrade 


th bsite and f , Kodi 7e 
a E E ETA PRIME 


TS Tee ne Ba Coa one mi d Apparently a real threat they get We can't quite identify the board used in this 
m aa are repairers Wh nen regularly (people don’t understand video, although we'd like to point out the boot-up 
SERED PAM peii NIE that Kodi doesn't provide content), screen for Raspbian is now a bit different, which 


it fooled many people until the instantly gives it away. A great effort, though. 
site reverted. 
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manda Coffey was talking 
with another mum at her 
school when she heard 
about Code Club for the first time. 
“It sounded really interesting,” 
Amanda tells us. “Iam nota 
coder, but I had dabbled in the 
past. I remember typing code 
into my Spectrum when I was six 
or seven... but I had never been 
taught to code. Coding wasn’t a 
scary thing, it was just something 


I hadn't learnt. I knew that most 
of my peers didn't feel the same 
way: they were scared of coding. 
I wanted my children to grow up 
seeing coding as just another tool, 
not something scary." 

After learning about Code Clubs 
from fellow mum Jasjit, Amanda 
decided to start one with her 


Amanda mostly teaches her 
students Scratch, but they do 
dabble in Python and HTML 


FIRFIELD 


PRIMARY 
CODE CLUB 


running club coach, Ian. Their 
Code Club has been running for 
nearly two years now and is always 
oversubscribed with students 
wanting to learn how to code. It's 
also resulted in some more formal 
lessons outside the Code Club to 
try to catch the kids who hadn't 
been able to get in. 

“I was standing in the 
playground when a child who had 
recently gone up to secondary 


I wanted my children to grow up 
seeing coding as just another tool, 
not something scary 


school walked in to meet her 
family,” mentions Amanda. “She 
wasn’t a Code Clubber, but had 
been taught by us in the lessons 
we delivered. She saw me and 

ran over, so excited, and told me 
that in computing lessons at their 
new school they were coding in 
Scratch, that the teacher had told 


Like a lot of Code Clubs, the gender 
ratio defies the IT industry stats 


them what game to make but only 
given them a few blocks. She was 
quite smug when she said it was 
easy and that her game worked 
perfectly and was great. 

“I have seen first hand how even 
a small amount of coding knowledge 
can help in the workplace," Amanda 
continues. “However, I also grew up 
with peers who thought it was worse 
than Latin, impossible to learn, too 
geeky, etc. This new generation 
will need coding to succeed, more 
than we ever have. If we can let 
them learn through playing whilst 
they are still young enough not to 
have the barriers society gives us 
in their heads, then they will get 
to secondary school and just see 
coding and computing as the tools 
they are." 

If you want to start your own 
CodeClub, you can find out more 
details at codeclub.org. 
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THe Raspserry Pi Ropotics CHALLENGE Comperirion 


t's weird to think that since we last had a Pi 

Wars, the original Robot Wars TV show has seen 

a revival and is already onto its second season. 
While the robots in that show fight to the very end, the 
only combat the Pi Wars robots face involves popping 


The event was a huge success 
and included special guest 
host Dr Lucy Rogers 


balloons. Although that doesn't mean the robots don't 
break down during other challenges... 

The event was a huge success and included special 
guest host Dr Lucy Rogers who, since appearing in the 
magazine last year talking about robot dinosaurs, has 
gone on to become a judge on the revived Robot Wars. 
Here are some pictures from Pi Wars 2017. 


Wh: * T all. 5 I 4 “4 - M 
^. d UP! o ex E A robot in the shape of Ely Cathedral (see below) 
= 1 em P is one thing, but one made out of a Fisher Price toy 
phone is quite another (photo by Sway Grantham) 


sia i 


b 


The Micro Pi Noon course for very small robots, built by Brian Corteil t One of this year's wackier designs, this robot version of Ely 
who was responsible for the robot build in The MagPi #51 E Cathedral was a favourite at the event (photo by Anne Carlill) 
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Want to keep your Raspberry Pi 
as secure as possible? Then lock 
it inside a lock box with a digital 
security code. At least with this 
one you can turn it on and off via 
a switch on the outside of the box. 
Does that perhaps ruin some of 
This is utterly stupendous. Gordon Hlavenka hacked the security measures? 

his actual car to control Mario Kart 64. If you watch 

the video, you can see him flash his lights as he 

jumps to drift around corners. He’s even able to use 

the real accelerator and brake pedals. Hopefully it 

get disconnected when he goes for an actual drive. 


A good arcade build is always 
lovely to look at, and this 
wooden creation is no different. 
We especially like the glowing 
RetroPie text embedded into the 
top of the wood. This is designed 
to sit on a tabletop, but we'd love 
to see some more old-school 
full-size cabinet builds. 


$ 9 So 
E- ze». Using an old iPhone 5 slide- 
out keyboard, this maker has 


managed to create a hybrid Pi 
Zero W case that has a screen 


We've had Pip-Boys from Fallout in the mag before, and a fully functioning keyboard 
but we really love the design considerations put into input. It's one of the smallest 
building this Fallout terminal. It's 3D printable, so you mobile PC applications we've 
can make your own if you want to. Just make sure to seen for the Raspberry Pi and it 
copy that retro green-and-black monitor style. looks cool as heck. 


This Raspberry Pi recognises five notes on an ocarina, 
so you can play the songs from the Legend of Zelda: 
Ocarina of Time to activate stuff around the house. It's 
so accurate that it lights specific LEDs for the specific 
notes being played. It comes with appropriate sound 
effects and recognises the best sound, Song of Storms, 
to turn on a humidifier. 
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Boasting the most successful Raspberry Pi- 
related channel on YouTube, meet Matt, the 
electric skateboard-riding Raspberry Pi Guy 


first set up my YouTube Raspberry Pi roundup videos being a 

channel because I noticed staple of the birthday celebrations. 

a massive lack of video With his website, Matt aimed 
tutorials for the Raspberry Pi,” to collect together “the many 
explains Matthew Timmons- strands of The Raspberry Pi Guy” 
Brown, known to many as The into one, neat, cohesive resource, 
Raspberry Pi Guy. At 17 years old, and it works. From newcomers to 


the Cambridge-based student has the credit card-sized computer 
more than 60,000 subscribers to to hardened Pi veterans, The 

his channel, making his account Raspberry Pi Guy offers aid and 
the most successful Raspberry Pi- inspiration for many. Looking for 
specific YouTube account to date. a review of the Raspberry Pi Zero? 


If you’ve attended a Raspberry Pi He's filmed one. Looking for a 


event, there's a good chance you've step-by-step guide to building a 

already met Matt. And if not, you'll Pi-powered Amazon Alexa? No 

have no doubt come across one or problem, there's one of those too. 

: more of his tutorials and builds Last summer, Matt introduced 
From speaking at events to j : d à 
creating videos and resources, Matt online. On more than one occasion, the world to his Raspberry Pi- 
iFimmors:Brown conunuse te e higo hes teanited onithe controlled electric skateboard, soon 
upon a wonderful reputation in the Pi H à . e à 

community as The Raspberry Pi Guy Raspberry Pi blog, with his yearly finding himself plastered over local 


Matt was invited to St James's Palace and the Houses of Parliament 
as part of the Raspberry Pi community celebrations in 2016 


86 | MägPi May 2017 raspberrypi.org/magpi 


Xt SEW AERE SZ 
px iu ATL Ks n 


v 


Tae 
CIERRE 


Matthew and Eben review footage from 
their appearance on local TV news 


press, as well as the BBC and tech 
sites like Adafruit and geek.com. 
And there's no question as to why 
the build was so popular. With 
YouTubers such as Casey Neistat 
increasing the demand for electric 
Skateboards on a near-daily basis, 
the call for a cheaper, home-brew 
version has quickly grown. Using 
a Raspberry Pi Zero, a Nintendo 
Wii Remote, and a little help 

from members of the Cambridge 
Makespace community, Matt built a 


science coursework, the build 
demonstrates Matt's passion for 
Space and physics. Used as a means 
of surveying terrain, LiDAR uses 
laser light to measure distance, 
allowing users to create 3D-scanned, 
high-resolution maps of a specific 
area. It is a perfect technology for 
exploring unknown worlds. 

In a recent interview at Hills 
Road Sixth Form College, where 
he is studying mathematics, 
further mathematics, physics, and 


If you've attended a Raspberry 
P1 event, theres a good chance 
you've already met Matt 


board capable of reaching 30km/h, 
with a battery range of 10km per 
charge. Alongside Neistat, Matt 
attributes the project inspiration to 
Australian student Tim Maier, 
whose build we previously covered 
in The MagPi. 

Despite the success and the fun 
of the electric skateboard (including 
convincing Raspberry Pi Trading 
CEO Eben Upton to have a go for 
local television news coverage), 
the project Matt is most proud of 
is his wireless LIDAR system for 
theoretical use on the Mars rovers. 
Built for his A Level computer 
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computer science, Matt revealed 
where his love of electronics 

and computer science started. 

“I originally became interested in 
computer science in 2012, whenI 
read a tiny magazine article about 
a computer that I would be able to 
buy with pocket money. This was a 
pretty exciting thing for a 12-year- 
old! Your own computer... for less 
than £30?" He went on to explain 
how it became his mission to learn 
all he could on the subject and how, 
months later, his YouTube channel 
came to life, cementing him firmly 
into the Raspberry Pi community. 
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You can help global seismology by adding your 
data to feeds from a growing number of users 


OSOP brings seismography to everyone with the incredible Raspberry Shake kit 


88 


The 

Raspberry Shake 
is very smal. It 
only needs 26 
GPIO pins, so it 
can work on any 
Pi model 
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eismic activity monitoring 
is important. It helps give 
people early warnings about 
possible natural disasters, as well as 
plotting how the earth beneath our 
feet is moving. It helps scientists to 
make better predictions and better 
models of our planet. 
“Our company is called 
OSOP and it’s existed for about 
ten years. We’re dedicated to 
making high-density solutions 
for earthquake monitoring.” 
Branden Christensen is the 
CEO of OSOP and he recently 
came to fame in the maker and 


Raspberry Pi communities when 
his company ran a very successful 
Kickstarter campaign for 
a consumer-grade seismograph. 
“That’s what we’ve been doing 
for years,” Branden continues. 
“We had a product that cost an 
order of magnitude less money 
than anything else on the market 
and with that product we’ve helped 
countries through geophysical 
institutes. That solution, even 
though it was an order of 
magnitude cheaper than other 
things available on the market, was 
still $5,000 a unit.” 


Turning to crowdfunding 
Like Raspberry Pi, they were 
interested in lowering the 
price even further and decided 
a network of hobbyist scientists 
with seismographs could have 
fun while still collecting 
useful data. 

“Were always interested in 
creating as high-density a network 
as we can,” explains Branden. “The 
motivations behind this are that 
with earthquake locations we always 


want to try and use automated 
processing systems, and those 
systems work best if you have a high 
density of stations. To have a really 
high level of confidence that seismic 
activity is of a certain magnitude 

in a certain place, you need to have 
high density. Raspberry Shake was 
born out of that philosophy, but it 
was also born out of the idea that 
we wanted to create a hobbyist 
seismograph. When we went into 
the Kickstarter campaign, we went 
into it thinking we just wanted to 
create a seismograph that will be 
cool for us and our friends. It was 
something we'd wanted to do as 
kind of a side project and we didn't 
know if there would be a market 
for it, so we thought why don’t we 
throw it on Kickstarter and we'll 
have our answer. 

*We thought if we can make the 
Kickstarter campaign successful 
and sell 20 or 30 of these units 
then we'll make it. We ended up 
hitting our funding level for 20 
units in 18 hours. And then we 
went up to $50,000, and finally we 
almost made it up to $100,000." 


raspberrypi.org/magpi 


The campaign raised $99,258 
from 597 backers, and more people 
began pre-ordering after the 
funding period passed. 


Upgrading the kit 

“When we hit $50,000, we knew we 
had stumbled upon a new market,” 
Branden tells us. “A market that 
hadn’t been exploited before for 
doing citizen science seismology. 
So at that point we completely 
redesigned the product. We took 


a more robust solution that was 
competitive in the market.” 

Branden admitted that the 
Raspberry Pi wasn’t the only small 
computer considered for what 
became the Raspberry Shake. 
However, to them it was the best 
choice for the project. 

“The Raspberry Pi was central 
to the success of our campaign... 
We were sitting around a table 
and we thought, you know what, 
we're pretty sure that there are 


Were always interested in 
creating as high-density a 
network as we can 


it from being this gee-whizz 
seismograph to being something 
for geophysical institutes as well. 
We changed those specifications. 
We were able to get better prices on 
components so we ended up with 


Monitoring is done in 
real-time so the accuracy 
is extremely good 


Raspberry Shakes 
have been shipped to 
about 60 countries 
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lots of geeks out there like us that 
have a bunch of Raspberry Pis just 
kicking around. 

*So we said, let's do this 
differently. Let's create a product 
that will run on any Raspberry Pi, 


A 
% NS 


and let's make it so that people 
don't have to buy the Pi from us - 
let's make it like a kit." Of all the 
different options you can buy, the 
most successful sales we've had to 
date are not the turnkey solutions 
that include the Pi and everything 
and you just plug them in; it's the 
one that has everything but the Pi." 
You can get yourself a Raspberry 
Shake, or find out more about 
it, from raspberryshake.net. 
Join the growing network of 
hobby seismologists! 


Each triangle represents 
a different station. 
Clicking on it brings up 
the seismograph history 


The 
assembled kit. 
It's very sensitive 
for sucha 
low-cost device 
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EVENT CALENDAR 


Find out what community-organised, Raspberry Pi- 
themed events are happening near you... 


ROANOKE 
RASPBERRY JAM 


Want a Raspberry Jam in your 
area? Want to start one? 
Email Ben Nuttall about it: 


ben@raspberrypi.org 


4 Q RASPBERRY JAM 
y BOGOTA 
3 x 

EDITOS NIRE EVENTIS REGULAR EVENTS 
SKIPTON RASPBERRY JAM LEAMINGTON RASPBERRY STAFFORD RASPBERRY JAM 
When: Saturday 13 May JAM 2.0 When: Tuesday 9 May 
Where: Craven College, When: Saturday 27 May Where: Stafford Library, 

Skipton, UK Where: Leamington Spa Library, Stafford, UK 
magpi.cc/2mYosyW Royal Leamington Spa, UK magpi.cc/2mvLiVJ 
Interaction, lightning talks magpi.cc/2mXSsOF A big meetup of Pi enthusiasts 
and project sharing with other Create sweet music with Minecraft where they all share ideas, help 
Raspberry Pi enthusiasts. and Sonic Pi on the Raspberry Pi. each other, and have fun! 
ROANOKE RASPBERRY NORWICH RASPBERRY CORNWALL TECH JAM 
JAM JAM When: Saturday 13 May 
When: Saturday 20 May When: Saturday 27 May Where: Cornwall College, Camborne, UK 
Where: CoLab Roanoke, Where: The Forum, cornwalltechjam.uk 

Roanoke, VA, USA Norwich, UK For anyone interested in 


magpi.cc/2mXQZrB 

Bring your favourite projects to 
share with other DIY makers. 
Attend a soldering workshop. 


magpi.cc/20H1tQh 

A separate part of the Norwich 
Gaming Festival focusing on 
learning with the Raspberry Pi. 


technology, of all ages and abilities. 
Ask questions and learn about 
programming: Scratch, Python, 
Minecraft, and much more. 


MägPi May 2017 raspberrypi.org/magpi 


LEAMINGTON 
RASPBERRY JAM 2.0 


Community 


HEAT MAP —€—— 


CAN YOU HELP INCREASE 
THE AMOUNT OF JAMS 
IN THE AREAS THAT NEED MORE? 


NBI GASPBERRY JAM 


At STAFFORD 
W RASPBERRY JAM 


NORWICH 
RASPBERRY JAM 


y 


O CORNWALL TECH JAM 


ve $ | | , 

i 4e pP 
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MINECRAFT = 

6 LIBRARY JAM ; 


MINECRAFT LIBRARY JAM 
When: Saturday 13 May 
Where: Central Library, 
Coventry, UK 
magpi.cc/2mvCGhO 
Build the world of Minecraft in code, 
7 As you may have seen in the 
news, there's a brand new 
kit and guidebook from the 
Raspberry Pi Foundation 
community team that gives top 
tips and advice on how to start 
your own Raspberry Jam. It also 
includes resources for making 
promotional material, along with 
some stickers to give out! You 
can find out more information 
about the kit here: rpf.io/jam 


then code your way around it on 
a Raspberry Pi. 


RASPBERRY JAM BOGOTÁ 

When: Saturday 20 May 

Where: Biblioteca Publica Virgilio Barco, 
Bogotá, Colombia 

magpi.cc/28Kavk3 

The premier Latin American Raspberry 

Jam returns for another session with 

a full day of events introducing people 

to the Raspberry Pi. 
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Party with Pi 

I’m a big Raspberry Pi fan and I made my 
way over to Cambridge for the Raspberry 

Pi Birthday Weekend in March, and it was 
great! Unfortunately, I only got to go on the 
Saturday and missed the talk you did on the 
Sunday about writing for The MagPi! I have 
a few ideas that I’d love to write for the 
magazine. Is there a video online of the talk 
so I can learn how to send articles to you? 
Lisa Nguyen 


Shame you missed the talk, Lisa! We are 
possibly going to be posting our own version 
online (our excellent video guy filmed it). 
However, if you can’t wait until then, a 
Raspberry Pi fan uploaded video of every talk 
to YouTube and you can see Rob give his talk 
there: magpi.cc/2nn5tRj. 

We’ll reiterate one of the key points about 
writing articles for The MagPi: just email 
Rob! You can get in touch with him directly 
at rob.zwetsloot@raspberrypi.org and he'll 
take it from there. 
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Aretro favourite. Will the Raspberry 
Pi be remembered so fondly many years 
later? We hope so! 


Forever third 
Congratulations on the sale of 
so many Raspberry Pis! Beating 
the Commodore 64 seems like 
no mean feat. How come you'll 
forever be third, though? Are 
the numbers of PCs and Macs 
really that insurmountable? 
Also what is the debate 
surrounding the numbers of 
the Commodore 64 sold? 
Jonny S 


Well, as explained in the article, 
there have been about 1.25 billion 
PCs sold, x86 IBM/Windows PCs to 
be exact, and 80 million Intel Macs 
as well. Sales of both aren't slowing 
down, so it’s not like competing 


E. M 


NATED 


with the C64 where a set number 
of machines was sold, and that 
number will never change. 

As for that C64 number, the 
controversy comes from various 
claims about how many have 
been sold. A book by an executive 
at Commodore claimed that a 
certain number sold consistently 
throughout its life, which adds 
up to a total of around 23 million. 
Reports by Commodore itself 
give a much lower number, 
and a count of all the serial 
numbers actually sold gets us 
to the 12.5 million number. 

This one is considered to be the 
most accurate. 
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The Big Birthday Weekend was amazing, and 
we hope to see more of you there next year! 
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FROM | HE FOR | J M: The error about the graphical package manager not 
m being in Raspbian is our fault - we missed it when 


it went to print, but realised afterwards that it was 


wrong. As we hadn't actually launched the issue 
yet, we decided to do a little update to the PDF. We 


The Raspberry Pi Forum is a hotbed of rarely do this with the magazine issues, and almost 
conversations and problem-solving for the never after it's out, so we made the call to do it for 
community. Join in via raspberrypi.org/forums pue agia eme, 


As for the missing pages, they’re in the print 
"ve just been having a read through issue 56, mainly the OS versions we've seen! Give the pages a little rub in 
choice at the moment. Some OSs for me to have a look at, case they need to unstick themselves. 
the camera one seems interesting. Anyway, glad you found an OS or two to check out 
Noticed one error, oddly for Raspbian. You say there is no from the guide! 

graphical manager installing, but there is. However, I've just 

checked online and it's different. It also seems to have quite a few 

more OSs covered than my print version (unless I was sleeping?). 

It jumped from Raspbian to something like OSMC/RetroPie. Some 

three or four more pages? Is there a big error in the print version? 
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WD PIDRIVE NODE ZERO 


Build your own mini DLNA + Samba file server, wireless 
mobile storage device, a Pi Music Box with local storage 
and so much more. 


Includes: 
A Io M d À age’ ; — * 314GB WD PiDrive, Raspberry Pi Zero, 
NO-- | : and custom adapter board 


e SD card with starter software 
* Mini HDMI adapter cable 


© WD LABS Learn more at wdlabs.io/mp57b 


Western Digital, WD, the WD logo, WDLabs, and the WDLabs logo are registered trademarks or trademarks of Western Digital Corporation or its affiliates in the U.S. and/or other countries. Raspberry Pi is a trademark of the Raspberry Pi Foundation. microSD is a trademark of SD-3C, 
LLC. The term HDMI is a trademark or registered trademark of HDMI Licensing LLC in the United States and other countries. All other marks are the property of their respective owners. As used for storage capacity, one gigabyte = one billion bytes. Total accessible capacity varies 
depending on operating environment. Product specifications subject to change without notice. Pictures shown may vary from actual product. © 2017 Western Digital Corporation or its affiliates. 


OF WDLABS 


$300+° WDLABS 
MUST BE WON! 


In association with 


(wpLABS 


WHAT WOULD 
YOU BUILD (wpLaBs 
WIIH IHE i 
WD PIDRIVE 
COMPUTE 
CENTRE KIT? 


To enter visit: Sones -e 
wdlabs.io/mp57contest oco D- 


Enter by 26 May 2017 
for your chance to win! 


Learn more: 


Find out more about the WD PiDrive Compute Centre: magpi.cc/ComputeCentre 


Terms & Conditions 

Competition closes on 26 May 2017. Prize is offered in the UK and US to participants aged 18 or over, except employees of the Raspberry Pi Foundation, the prize 
supplier, their families or friends. Winners will be notified by email after the draw date. By entering the competition, the winner consents to any publicity generated from 
the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine (unless otherwise stated upon entry). We don't like 
spam. Participants’ details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. 


94 | MägPi May 2017 raspberrypi.org/magpi 


v7 


Li lono Pi 
A professional I/O expansion 
for your Raspberry Pi 


Board or pre-assembled DIN module with: 

* 4 relay outputs 250V - 6A 

* 2 analog inputs O-30V 

* 2 analog inputs O-3.3V on internal headers ly \ 

* 7 configurable digital |/O 
(up to 3 open collector outputs 
with over-current protection) 

* 1-Wire and Wiegand support 


* 9-28Vdc power supply oo 
* Real time clock 
* CE/ROHS Certified — 20 (0) 
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www.sferalabs.cc 


Column THE FINAL WORD 


MATT RICHARDSON 


Matt Richardson is the executive director of Raspberry Pi 
Foundation North America and author of Getting Started 
with Raspberry Pi. Contact him on Twitter @MattRichardson. 


PRODUCT OR 
" PROJECT? 


Major product makers are opening their arms to hobbyists. 
Matt Richardson explores why 


aking inspiration from a widely known 
Mahatma Gandhi quotation, I like to tell 
people, “make the thing you wish to see 
in the world.” In other words, you don’t have to 
wait for a company to create the exact product 
you want. Prototyping with hardware has become 
easier and more affordable, empowering people to 
make products that suit their needs perfectly. And 
the people making these things aren’t necessarily 
electrical engineers, computer scientists, or 
product designers. They’re not even necessarily 


could also sense depth, a feature that would be useful 
for identifying the position of objects in a space. At 
first, there was no hacker support from Microsoft, 
so Adafruit Industries announced a $3,000 bounty 
to create open-source drivers so that anyone could 
access the features of Kinect for their own projects. 
Since then, Microsoft has embraced the use of Kinect 
for these purposes. 

Consumer product companies even make versions 
of their products that are specifically meant for 
hacking, making, and learning. Belkin’s WeMo home 


adults. They’re often self-taught hobbyists who are 
empowered by maker-friendly technology. 

It's a subject I’ve been very interested in, and I 
have written about it in this column before. Here’s 
what I’ve noticed: the flow between maker project 
and consumer product moves in both directions. In 
other words, consumer products can start off as maker 
projects. Just take a look at the story behind many of 
the crowdfunded products on sites such as Kickstarter. 
Conversely, consumer products can evolve into maker 
products as well. The cover story for this issue of 
The MagPi is a perfect example of that. Google has given 
you the resources you need to build your own dedicated 
Google Assistant device. How cool is that? 

But consumer products becoming hackable hardware 
isn't always an intentional move by the product's 
maker. In the 2000s, TiVo set-top DVRs were a hot 
product and their most enthusiastic fans figured out 
how to hack the product to customise it to meet their 
needs without any kind of support from TiVo. 


Embracing change 

But since then, things have changed. For example, 
when Microsoft's Kinect for the Xbox 360 was released 
in 2010, makers were immediately enticed by its 
capabilities. It not only acted as a camera, but it 
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automation product line includes the WeMo Maker, 
a device that can act as a remote relay or sensor and 
hook into your home automation system. And iRobot 
offers Create 2, a hackable version of its Roomba 
floor-cleaning robot. It's aimed at STEM educators, 
but could be used for personal projects too. Electronic 
instrument maker Korg takes its maker-friendly 
approach to the next level by releasing the schematics 
for some of its analog synthesizer products. 
Why would a company want to do this? I think 
there are a few possible reasons. For one, it's a way of 
encouraging consumers to create a community around 
a product. It could be a way for innovation with the 
product to continue, unchecked by the firm's own 
limits on resources. For certain, it’s an awesome feel- 
good way for a company to empower their own users. 
Whatever the reason these products exist, it's the 
digital maker who comes out ahead. They have more 
affordable tools, materials, and resources to create 
their own customised products and possibly learn a 
thing or two along the way. 
With maker-friendly, hackable products, being 
a creator and being a consumer aren't mutually 
exclusive. In fact, you're probably getting the best of 
both worlds: great products and great opportunities 
to make the thing you wish to see in the world. 
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Code Club is a nationwide network of volunteer-led after school clubs 
for children aged 9-11. 


We're always looking for people with coding skills to volunteer to run 
a club at their local primary school, library or community centre for an 
hour a week. 


You can team up with colleagues, a teacher will be there to support 
you and we provide all the materials you'll need to help get children 
excited about digital making. 


There are loads of ways to get involved! 


So to find out more, join us at www.codeclub.org.uk 


This advertising space was kindly donated to Code Club by MagPi Magazine 
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Build your own credit card 
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Get started with programming 
Set up a Media Center 
Make simple electronic circuits 
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